ResUtilSetBinaryValue 関数 (resapi.h)
クラスター データベースにバイナリ値を設定します。
構文
DWORD ResUtilSetBinaryValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] const LPBYTE pbNewValue,
[in] DWORD cbNewValueSize,
[in, out, optional] LPBYTE *ppbOutValue,
[in, out] LPDWORD pcbOutValueSize
);
パラメーター
[in] hkeyClusterKey
クラスター データベース内のバイナリ値の場所を識別するキー。
[in] pszValueName
更新する値の名前を含む null で終わる Unicode 文字列。
[in] pbNewValue
新しいバイナリ値へのポインター。
[in] cbNewValueSize
新しいバイナリ値のサイズ。
[in, out, optional] ppbOutValue
新しいバイナリ値へのポインターのアドレス。
[in, out] pcbOutValueSize
ppbOutValue が指す値のサイズ (バイト単位) が返される DWORD へのポインター。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。
| リターン コード | 説明 |
|---|---|
|
メモリ割り当て中にエラーが発生しました。 |
注釈
ResUtilSetBinaryValue ユーティリティ関数は、関数 LocalAlloc を使用して ppbOutValue ポインターのメモリを割り当て、Cluster API 関数 ClusterRegSetValue を呼び出して、新しい値をこのバッファーにコピーします。 ポインターが NULL でない場合、 ResUtilSetBinaryValue も割り当てを解除します。 この関数の呼び出し元として、 LocalFree 関数を使用してバッファーの割り当てを解除する必要があります。
次のリソース DLL エントリ ポイント関数から ResUtilSetBinaryValue を呼び出さないでください。
ResUtilSetBinaryValue は、他のリソース DLL エントリ ポイント関数またはワーカー スレッドから安全に呼び出すことができます。 詳細については、「 リソース DLL での回避する関数呼び出し」を参照してください。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |