ホーム › Networking.Clustering › PRESUTIL_FIND_MULTI_SZ_PROPERTY

PRESUTIL_FIND_MULTI_SZ_PROPERTY

コールバック

シグネチャ

DWORD PRESUTIL_FIND_MULTI_SZ_PROPERTY(
    void* pPropertyList,
    DWORD cbPropertyListSize,
    LPWSTR pszPropertyName,
    LPWSTR* pszPropertyValue,
    DWORD* pcbPropertyValueSize
);

パラメーター

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

公式ドキュメント

プロパティリスト内の複数文字列プロパティを検索します。PRESUTIL_FIND_MULTI_SZ_PROPERTY 型は、この関数へのポインターを定義します。

戻り値

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

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

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

解説(Remarks)

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

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