ResUtilAddUnknownProperties 函数 (resapi.h)

从群集数据库中检索一组未知属性，并将其追加到属性列表的末尾。

语法

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

参数

[in] hkeyClusterKey

指向群集数据库密钥的指针，该密钥标识要读取的属性的位置。

[in] pPropertyTable

指向描述对象的通用属性和私有属性的属性 表 的指针。 在群集数据库中找到的、不在此属性表中的任何属性将添加到属性列表中。

[in, out] pOutPropertyList

指向接收返回属性的缓冲区的指针。 输入时，缓冲区可以包含现有属性列表，也可以为空。 在输出时，检索到的属性将追加到现有列表的末尾，或者，如果缓冲区为空，则将作为新属性列表返回。

[in] pcbOutPropertyListSize

pOutPropertyList 指向的缓冲区的总字节大小。 缓冲区的大小必须足够大，才能包含要返回的现有属性列表和属性列表。

[in, out] pcbBytesReturned

输入时，指针指向 pOutPropertyList 缓冲区包含的属性列表的字节大小。 输出时，指针指向 pOutPropertyList 指向的属性列表中的总字节数。

[in, out] pcbRequired

在输出中， 指向保存返回的属性列表所需的总字节数。 如果 pOutPropertyList 缓冲区太小，则可以将其重新分配为所需的大小。

返回值

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

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

注解

下图说明了 ResUtilAddUnknownProperties 的输入和输出参数之间的关系：

ResUtilAddUnknownProperties 实用工具函数枚举存储在 hkeyClusterKey) 下的群集数据库中 (的属性，并在 pPropertyTable) (属性表中查找相应的属性。 群集数据库中列出但未在属性表中列出的每个属性都会添加到属性列表 (pOutPropertyList) 。

要求

另请参阅

RESUTIL_PROPERTY_ITEM

ResUtilSetUnknownProperties