ResUtilGetMultiSzValue 函数 (resapi.h)

群集数据库返回多个字符串值。

语法

DWORD WINAPI_INLINE ResUtilGetMultiSzValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPWSTR  *ppszOutValue,
  [out]           LPDWORD pcbOutValueSize
);

参数

[in] hkeyClusterKey

标识群集数据库中多个字符串值的位置的键。

[in] pszValueName

指向以 null 结尾的 Unicode 字符串的指针,该字符串包含要检索的值的名称。

[out, optional] ppszOutValue

指向检索到的值的指针的地址。

[out] pcbOutValueSize

指向 DWORD 的指针,其中返回 ppszOutValue 指向的缓冲区的大小(以字节为单位)。

返回值

如果操作成功,函数将返回 ERROR_SUCCESS

如果操作失败,该函数将返回 系统错误代码。 下面是可能的错误代码。

返回代码 说明
ERROR_NOT_ENOUGH_MEMORY
内存分配期间出错。

注解

完成为 ResUtilGetMultiSzValue 实用工具函数返回的值分配的内存后,必须调用函数 LocalFree 才能释放它。

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目标平台 Windows
标头 resapi.h

另请参阅

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetSzValue