ホーム › Networking.Clustering › PRESUTIL_FIND_SZ_PROPERTY

PRESUTIL_FIND_SZ_PROPERTY

コールバック

シグネチャ

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

パラメーター

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

公式ドキュメント

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

戻り値

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

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

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

解説(Remarks)

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

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