读取32位整型值 - RegistryGetDword

函数简介

读取32位整型的注册表值(REG_DWORD),用于获取数值型配置。

接口名称

RegistryGetDword

DLL调用

int32_t RegistryGetDword(int64_t instance, int64_t key, const char* valueName)

参数定义:

• instance (长整型数): OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。
• key (长整型数): 注册表键句柄,由 RegistryOpenKey 或 RegistryCreateKey 返回
• valueName (字符串): 值名称

示例:

// 创建OLA对象
int64_t instance = CreateCOLAPlugInterFace();

// 打开注册表键
int64_t key = RegistryOpenKey(instance, 1, "Software\\OLAPlug\\Config");

if (key != 0) {
    // 读取版本号
    int32_t version = RegistryGetDword(instance, key, "Version");
    printf("版本号: %d\n", version);
    
    // 读取最大连接数
    int32_t maxConn = RegistryGetDword(instance, key, "MaxConnections");
    printf("最大连接数: %d\n", maxConn);
    
    // 读取启用标志
    int32_t enabled = RegistryGetDword(instance, key, "Enabled");
    if (enabled == 1) {
        printf("功能已启用\n");
    } else {
        printf("功能未启用\n");
    }
    
    // 关闭注册表键
    RegistryCloseKey(instance, key);
}

// 释放资源
DestroyCOLAPlugInterFace(instance);

返回值

整型数:

• 成功: 返回读取到的32位整型值
• 失败或不存在: 返回 0

注意事项

1. 如果值不存在或类型不匹配,将返回 0
2. 无法区分返回的 0 是实际值还是错误标志,建议先用 RegistryKeyExists 检查
3. REG_DWORD 类型为32位无符号整数
4. 读取前建议确认值的类型正确