ResUtilGetProperties 函数 (resapi.h)

群集数据库中检索由属性表指定的属性,并在属性列表中返回这些属性。 PRESUTIL_GET_PROPERTIES类型定义指向此函数的指针。

语法

DWORD ResUtilGetProperties(
  [in]  HKEY                         hkeyClusterKey,
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out] PVOID                        pOutPropertyList,
  [in]  DWORD                        cbOutPropertyListSize,
  [out] LPDWORD                      pcbBytesReturned,
  [out] LPDWORD                      pcbRequired
);

parameters

[in] hkeyClusterKey

指向群集数据库密钥的指针,该密钥标识要检索的属性的位置。

[in] pPropertyTable

指向描述要检索的属性 的RESUTIL_PROPERTY_ITEM 结构的数组的指针。

[out] pOutPropertyList

指向要在其中返回属性列表的输出缓冲区的指针。

[in] cbOutPropertyListSize

pOutPropertyList 指向的输出缓冲区的大小(以字节为单位)。

[out] pcbBytesReturned

指向 pOutPropertyList 指向的属性列表中的字节总数的指针。

[out] pcbRequired

指向 pOutPropertyList 太小时所需的字节数的指针。

返回值

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

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

返回代码 说明
ERROR_BAD_ARGUMENTS
一个或多个输入参数无效。
ERROR_MORE_DATA
输出缓冲区太小,无法包含生成的数据。 “线路板”参数指示所需的大小。
ERROR_NOT_ENOUGH_MEMORY
分配内存时出错。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 企业版、Windows Server 2008 Datacenter
目标平台 Windows
标头 resapi.h
Library ResUtils.lib
DLL ResUtils.dll

请参阅

ResUtilGetPrivateProperties