Win32 API 日本語リファレンス
ホーム › Networking.Clustering › PRESUTIL_FIND_DWORD_PROPERTY

PRESUTIL_FIND_DWORD_PROPERTY

コールバック

シグネチャ

DWORD PRESUTIL_FIND_DWORD_PROPERTY(
    void* pPropertyList,
    DWORD cbPropertyListSize,
    LPWSTR pszPropertyName,
    DWORD* pdwPropertyValue
);

パラメーター

フィールド型説明
pPropertyListvoid*値を検索する対象のプロパティリストへのポインターです。
cbPropertyListSizeDWORDpPropertyList に含まれるデータのサイズ (バイト単位) です。
pszPropertyNameLPWSTR検索する値の名前を含む、null で終わる Unicode 文字列へのポインターです。
pdwPropertyValueDWORD*プロパティリストバッファーに格納されているデータの実際の値へのポインターです。

公式ドキュメント

プロパティリスト内の unsigned long 型のプロパティ値を検索します。PRESUTIL_FIND_DWORD_PROPERTY 型は、この関数へのポインターを定義します。

戻り値

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

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

戻り値 説明
ERROR_INVALID_DATA
データの形式が正しくありません。
ERROR_FILE_NOT_FOUND
プロパティリスト内にプロパティが見つかりませんでした。

解説(Remarks)

操作が成功した場合、pdwPropertyValue はプロパティリストバッファー内を直接指します。pdwPropertyValue を使用する際は、プロパティリストの書式を壊さないように注意してください。

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