枚举值名称 - RegistryEnumValues
函数简介
枚举当前注册表键下的所有值名称,返回JSON数组格式。
接口名称
RegistryEnumValues
DLL调用
int64_t RegistryEnumValues(int64_t instance, int64_t key);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| key | 长整数型 | 注册表键句柄,由 RegistryOpenKey 或 RegistryCreateKey 返回 |
示例
int64_t instance = CreateCOLAPlugInterFace();
int64_t key = RegistryOpenKey(instance, 1, "Software\\OLAPlug\\Config");
if (key != 0) {
int64_t jsonPtr = RegistryEnumValues(instance, key);
if (jsonPtr != 0) {
const char* json = (const char*)jsonPtr;
// 输出示例: ["AppName","Version","Enabled","InstallPath"]
FreeStringPtr(instance, jsonPtr);
}
RegistryCloseKey(instance, key);
}
DestroyCOLAPlugInterFace(instance);
返回值
长整数型。成功返回包含所有值名称的JSON数组字符串指针,例如 ["Value1","Value2"];失败或无值返回 0 或空数组 []。返回的字符串指针需调用 FreeStringPtr 释放内存。
注意事项
- 返回的是JSON数组格式,需要解析后使用。
- 默认值(空名称)可能显示为空字符串
""。 - 不包含值的类型和数据,仅包含名称。
