打开注册表键 - RegistryOpenKey

函数简介

打开已存在的注册表键，用于后续读取或修改操作。仅在键已存在时返回有效句柄。

接口名称

RegistryOpenKey

DLL调用

int64_t RegistryOpenKey(int64_t instance, int32_t rootKey, const char* subKey)

参数定义:

• instance (长整型数): OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。
• rootKey (整型数): 根键类型,可选值如下:
  • 0: HKEY_CLASSES_ROOT
  • 1: HKEY_CURRENT_USER
  • 2: HKEY_LOCAL_MACHINE
  • 3: HKEY_USERS
  • 4: HKEY_CURRENT_CONFIG
• subKey (字符串): 子键路径,例如 "Software\Microsoft\Windows"

示例:

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

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

if (key != 0) {
    printf("成功打开注册表键\n");
    
    // ... 执行读写操作 ...
    
    // 关闭注册表键
    RegistryCloseKey(instance, key);
} else {
    printf("打开注册表键失败\n");
}

// 释放资源
DestroyCOLAPlugInterFace(instance);

返回值

长整型数:

• 成功: 返回注册表键句柄(非0值)
• 失败: 返回 0

注意事项

1. 仅在键已存在时返回有效句柄,如果键不存在将返回 0
2. 使用完成后必须调用 RegistryCloseKey 释放句柄
3. 建议在操作敏感系统键时谨慎处理,避免误操作
4. 如果需要在键不存在时自动创建,请使用 RegistryCreateKey