ホーム › Networking.Clustering › PRESUTIL_SET_BINARY_VALUE

PRESUTIL_SET_BINARY_VALUE

コールバック

シグネチャ

DWORD PRESUTIL_SET_BINARY_VALUE(
    HKEY hkeyClusterKey,
    LPWSTR pszValueName,
    BYTE* pbNewValue,
    DWORD cbNewValueSize,
    BYTE** ppbOutValue,
    DWORD* pcbOutValueSize
);

パラメーター

フィールド	型	説明
hkeyClusterKey	HKEY	クラスターデータベース内でバイナリ値が格納されている位置を示すキーです。
pszValueName	LPWSTR	更新する値の名前を格納した、null で終わる Unicode 文字列です。
pbNewValue	BYTE*	新しいバイナリ値へのポインターです。
cbNewValueSize	DWORD	新しいバイナリ値のサイズです。
ppbOutValue	BYTE**	新しいバイナリ値へのポインターのアドレスです。
pcbOutValueSize	DWORD*	ppbOutValue が指す値のサイズ (バイト単位) が返される DWORD へのポインターです。

公式ドキュメント

クラスターデータベースにバイナリ値を設定します。

戻り値

操作に成功した場合、この関数は ERROR_SUCCESS を返します。

操作に失敗した場合、この関数はシステムエラーコードを返します。次のエラーコードが返されることがあります。

戻り値	説明
ERROR_NOT_ENOUGH_MEMORY	メモリの割り当て中にエラーが発生しました。

解説(Remarks)

ResUtilSetBinaryValue ユーティリティ関数は、LocalAlloc 関数を使用して ppbOutValue ポインター用のメモリを割り当て、Cluster API の ClusterRegSetValue 関数を呼び出した後、新しい値をこのバッファーにコピーします。ポインターが NULL でない場合、ResUtilSetBinaryValue はそのメモリの解放も行います。この関数の呼び出し元は、LocalFree 関数を使用してバッファーを解放する責任があります。

次のリソース DLL エントリポイント関数から ResUtilSetBinaryValue を呼び出さないでください。

ResUtilSetBinaryValue は、これら以外のリソース DLL エントリポイント関数やワーカースレッドから安全に呼び出すことができます。詳細については、リソース DLL で呼び出しを避けるべき関数を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)