共用方式為

resUtilGetPropertiesToParameterBlock 函式 (resapi.h)

  • 發行項

從叢集資料庫擷取屬性數據表所指定的屬性，並在參數區塊中傳回它們。

語法

DWORD ResUtilGetPropertiesToParameterBlock(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out]           LPBYTE                       pOutParams,
  [in]            BOOL                         bCheckForRequiredProperties,
  [out, optional] LPWSTR                       *pszNameOfPropInError
);

參數

[in] hkeyClusterKey

識別要擷取之屬性位置的叢集資料庫索引鍵指標。

[in] pPropertyTable

描述要處理之屬性之 RESUTIL_PROPERTY_ITEM 結構的陣列指標。

[out] pOutParams

要填滿的輸出參數區塊指標。

[in] bCheckForRequiredProperties

指定如果遺漏必要屬性，是否應該產生錯誤。

[out, optional] pszNameOfPropInError

字串指標的位址，用來傳回遺漏必要屬性所產生的錯誤名稱。 ppszNameOfPropInError 屬性是選擇性的。

傳回值

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

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

傳回碼 Description
ERROR_BAD_ARGUMENTS
 一或多個輸入參數無效。
ERROR_NOT_ENOUGH_MEMORY
 配置記憶體時發生錯誤。

備註

使用 ResUtilGetPropertiesToParameterBlock 公用程式函式，pPropertyTable 所指向的屬性數據表可以包含預設值。

規格需求

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

另請參閱

RESUTIL_PROPERTY_ITEM