共用方式為

ResUtilSetPropertyTableEx 函式 (resapi.h)

  • 發行項

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

語法

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

參數

[in] hkeyClusterKey

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

[in] pPropertyTable

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

Reserved

保留的。

[in] bAllowUnknownProperties

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

[in] pInPropertyList

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

[in] cbInPropertyListSize

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

[in] bForceWrite

強制將屬性值寫入叢集資料庫，即使新值與現有值相同也一樣

[out, optional] pOutParams

要保存傳回數據 的參數區塊 指標。 當指定此為指標時，只會將不同於輸入緩衝區中的參數寫入參數區塊。

傳回值

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

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

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

備註

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

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

規格需求

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

另請參閱

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTable