ホーム › Networking.Clustering › PRESUTIL_FIND_BINARY_PROPERTY

PRESUTIL_FIND_BINARY_PROPERTY

コールバック

シグネチャ

DWORD PRESUTIL_FIND_BINARY_PROPERTY(
    void* pPropertyList,
    DWORD cbPropertyListSize,
    LPWSTR pszPropertyName,
    BYTE** pbPropertyValue,
    DWORD* pcbPropertyValueSize
);

パラメーター

フィールド	型	説明
pPropertyList	void*	値を検索する対象のプロパティリストへのポインターです。
cbPropertyListSize	DWORD	pPropertyList で指定されたプロパティリストのサイズ (バイト単位) です。
pszPropertyName	LPWSTR	検索するプロパティの名前を格納した、null で終わる Unicode 文字列へのポインターです。
pbPropertyValue	BYTE**	プロパティ値のコピーを格納するバッファー (この関数によって割り当てられます) を指す BYTE ポインターへのポインターです。割り当てられたメモリを解放するには、(*pbPropertyValue に対して) LocalFree を呼び出す必要があります。値が不要な場合は、このパラメーターに NULL を渡します。
pcbPropertyValueSize	DWORD*	返される値のサイズ (バイト単位) へのポインターです。サイズが不要な場合は、このパラメーターに NULL を渡します。

公式ドキュメント

プロパティリスト内で指定されたバイナリプロパティを検索し、そのプロパティの値を返すこともできます。PRESUTIL_FIND_BINARY_PROPERTY 型は、この関数へのポインターを定義します。

戻り値

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

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

戻り値	説明
ERROR_INVALID_DATA	プロパティリストの書式が正しくありません。
ERROR_NOT_ENOUGH_MEMORY	プロパティ値を返すためのバッファーを割り当てられませんでした。
ERROR_FILE_NOT_FOUND	指定されたプロパティがプロパティリスト内に見つかりませんでした。

解説(Remarks)

ResUtilFindBinaryProperty が成功した場合、pbPropertyValue は pPropertyList に格納されているデータのコピーを指します。メモリリークを防ぐため、pbPropertyValue に対して必ず LocalFree を呼び出してください。

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