共用方式為


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

如果作業失敗,函式會傳回 系統錯誤碼。 以下是可能的錯誤碼。

傳回碼 Description
ERROR_NOT_ENOUGH_MEMORY
配置記憶體時發生錯誤。

備註

下圖說明 ResUtilAddUnknownProperties 輸入和輸出參數之間的關聯性:

此圖顯示兩個緩衝區中個別列出的輸入和輸出參數。輸出參數清單已新增兩個未知的屬性。

ResUtilAddUnknownProperties 公用程式函式會列舉儲存在叢集資料庫中的屬性, (hkeyClusterKey) 底下,並在屬性數據表中尋找對應的屬性, (pPropertyTable) 。 每個列在叢集資料庫中但未列在屬性表中的屬性都會新增至屬性清單 (pOutPropertyList) 。

規格需求

需求
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目標平台 Windows
標頭 resapi.h
程式庫 ResUtils.lib
Dll ResUtils.dll

另請參閱

RESUTIL_PROPERTY_ITEM

ResUtilSetUnknownProperties