读取字符串值 - RegistryGetString

函数简介

读取字符串类型的注册表值（REG_SZ/REG_EXPAND_SZ）。

接口名称

RegistryGetString

DLL调用

int64_t RegistryGetString(int64_t instance, int64_t key, const char* valueName);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
key	长整数型	注册表键句柄，由 RegistryOpenKey 或 RegistryCreateKey 返回
valueName	字符串	值名称，空字符串表示读取默认值

示例

int64_t instance = CreateCOLAPlugInterFace();

int64_t key = RegistryOpenKey(instance, 1, "Software\\OLAPlug\\Config");
if (key != 0) {
    int64_t strPtr = RegistryGetString(instance, key, "AppName");
    if (strPtr != 0) {
        const char* appName = (const char*)strPtr;
        FreeStringPtr(instance, strPtr);
    }
    RegistryCloseKey(instance, key);
}

DestroyCOLAPlugInterFace(instance);

返回值

长整数型。成功返回字符串内容的指针（非0值），失败或不存在返回 0。返回的字符串指针需调用 FreeStringPtr 释放内存。

注意事项

• 空字符串作为值名称表示读取默认值。
• 支持读取 REG_SZ 和 REG_EXPAND_SZ 类型。
• 如果值类型不是字符串类型，将返回 0。