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
ppbOutValue が指すバッファーのサイズ (バイト単位) が返される DWORD へのポインター。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。
| リターン コード | 説明 |
|---|---|
|
値にメモリを割り当てる際にエラーが発生しました。 |
注釈
ResUtilGetBinaryValue ユーティリティ関数は、値に必要なメモリを割り当てる処理を行い、クラスター API 関数 ClusterRegQueryValue を呼び出します。 割り当てられたメモリの使用が完了したら、 LocalFree 関数を呼び出して解放する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |