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 |
---|---|
|
配置記憶體時發生錯誤。 |
備註
下圖說明 ResUtilAddUnknownProperties 輸入和輸出參數之間的關聯性:
ResUtilAddUnknownProperties 公用程式函式會列舉儲存在叢集資料庫中的屬性, (hkeyClusterKey) 底下,並在屬性數據表中尋找對應的屬性, (pPropertyTable) 。 每個列在叢集資料庫中但未列在屬性表中的屬性都會新增至屬性清單 (pOutPropertyList) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
目標平台 | Windows |
標頭 | resapi.h |
程式庫 | ResUtils.lib |
Dll | ResUtils.dll |