通过

ResUtilGetAllProperties 函数 (resapi.h)

  • 项目

返回一个属性列表，其中包含群集对象的所有默认属性和未知属性。 PRESUTIL_GET_ALL_PROPERTIES类型定义指向此函数的指针。

语法

DWORD ResUtilGetAllProperties(
  [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

OutBuffer 指向的输出缓冲区的大小（以字节为单位）。

[out] pcbBytesReturned

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

[out] pcbRequired

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

返回值

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

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

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

注解

ResUtilGetAllProperties 实用工具函数在属性列表中为每个属性创建一个条目，如下所示：

  • 包含在 属性表中。
  • 包含在 群集数据库中 的 由 ClusterKey 参数标识的键下方，而不考虑属性是否包含在属性表中。

要求

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

请参阅

RESUTIL_PROPERTY_ITEM