ResUtilSetPrivatePropertyList 函式 (resapi.h)

設定叢集物件的私用屬性。

語法

DWORD ResUtilSetPrivatePropertyList(
  [in] HKEY        hkeyClusterKey,
  [in] const PVOID pInPropertyList,
  [in] DWORD       cbInPropertyListSize
);

參數

[in] hkeyClusterKey

識別要設定之屬性位置的叢集資料庫索引鍵。

[in] pInPropertyList

輸入緩衝區的指標，其中包含 要設定之屬性的名稱和值的屬性清單 。

[in] cbInPropertyListSize

以位元組為單位的輸入緩衝區大小指標， 由 pInPropertyList 指向。

傳回值

如果作業成功，函式會 傳回ERROR_SUCCESS。

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

傳回碼	Description
ERROR_BAD_ARGUMENTS	一或多個輸入參數無效。
ERROR_INVALID_DATA	屬性數據的長度發生問題。
ERROR_INSUFFICIENT_BUFFER	pInPropertyList 指向的輸入緩衝區是 NULL。
ERROR_INVALID_PARAMETER	屬性名稱的語法無效。

備註

ResUtilSetPrivatePropertyList 公用程式函式中設定的屬性會放在叢集資料庫下方指定之物件的索引鍵下方，與屬性清單中的名稱所指定完全相同。 如果屬性的名稱包含反斜杠字元 (\) ，反斜杠字元前面的每個字串都會解譯為子機碼名稱，而最後一個反斜杠字元後面的最後一個字符串會解譯為值名稱。

請勿從下列資源 DLL 進入點函式呼叫 ResUtilSetPrivatePropertyList ：

• 關閉
• 離線
• 線上
• 開啟
• 終止

ResUtilSetPrivatePropertyList 可以從任何其他資源 DLL 進入點函式或背景工作線程安全地呼叫。 如需詳細資訊，請參閱 在資源 DLL 中避免的函數調用。

規格需求

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

另請參閱

ResUtilVerifyPrivatePropertyList