ホーム › Networking.Clustering › PRESUTIL_GET_BINARY_VALUE

PRESUTIL_GET_BINARY_VALUE

コールバック

シグネチャ

DWORD PRESUTIL_GET_BINARY_VALUE(
    HKEY hkeyClusterKey,
    LPWSTR pszValueName,
    BYTE** ppbOutValue,
    DWORD* pcbOutValueSize
);

パラメーター

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

公式ドキュメント

クラスターデータベースからバイナリ値を取得します。

戻り値

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

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

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

解説(Remarks)

ResUtilGetBinaryValue ユーティリティ関数は、値に必要なメモリの割り当てを行ったうえで、Cluster API の関数 ClusterRegQueryValue を呼び出します。割り当てられたメモリが不要になったら、LocalFree 関数を呼び出して解放する必要があります。

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