resUtilSetPropertyTable 函式 (resapi.h)

根據屬性數據表的屬性清單，設定叢集資料庫中的屬性。

語法

DWORD ResUtilSetPropertyTable(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [out, optional] LPBYTE                       pOutParams
);

參數

[in] hkeyClusterKey

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

[in] pPropertyTable

描述要設定之屬性之 RESUTIL_PROPERTY_ITEM 結構的陣列指標。

Reserved

保留的。

[in] bAllowUnknownProperties

指出是否應該接受 未知的屬性 。 如果應該接受此參數，此參數會設定為 TRUE ，否則 為 FALSE 。

[in] pInPropertyList

包含屬性清單的輸入緩衝區指標。

[in] cbInPropertyListSize

輸入緩衝區的位元組大小， cbInPropertyList 所指向。

[out, optional] pOutParams

要保存傳回數據 的參數區塊 指標。 如果指定，則參數只有在與輸入緩衝區中的參數不同時才會寫入。

傳回值

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

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

傳回碼	Description
ERROR_BAD_ARGUMENTS	一或多個輸入參數無效。
ERROR_INSUFFICIENT_BUFFER	cbInPropertyListSize 中指定的輸入緩衝區大小太小。
ERROR_INVALID_DATA	pInPropertyList 所指向的輸入緩衝區為 NULL、屬性名稱無效，或屬性值太小。
ERROR_INVALID_PARAMETER	pPropertyTable 所指向之屬性數據表中屬性的語法、格式或類型不正確，或是屬性是唯讀且無法設定的。

備註

如果屬性表中指定的值已經存在於叢集資料庫中，則不會寫入值。 如需強制寫入所有值的資訊，請參閱 ResUtilSetPropertyTableEx。

請勿從下列資源 DLL 進入點函式呼叫 ResUtilSetPropertyTable 。

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

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

規格需求

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

另請參閱

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTableEx