ResUtilGetBinaryValue 函式 (resapi.h)

從叢集資料庫傳回二進位值。

語法

DWORD ResUtilGetBinaryValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPBYTE  *ppbOutValue,
  [out]           LPDWORD pcbOutValueSize
);

參數

[in] hkeyClusterKey

叢集資料庫中的索引鍵，可識別要擷取之值的位置。

[in] pszValueName

Null 終止的 Unicode 字串指標，其中包含要擷取之值的名稱。

[out, optional] ppbOutValue

所擷取值的指標位址。

[out] pcbOutValueSize

DWORD 的指標，其中會傳回 ppbOutValue 所指向之緩衝區的位元組大小。

傳回值

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

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

傳回碼	Description
ERROR_NOT_ENOUGH_MEMORY	配置值的記憶體時發生錯誤。

備註

ResUtilGetBinaryValue 公用程式函式會負責配置值的必要記憶體，然後呼叫 Cluster API 函式 ClusterRegQueryValue。當您完成配置記憶體時，您必須呼叫 LocalFree 函式來釋放它。

規格需求

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