ResUtilFindLongProperty 関数 (resapi.h)

[アーティクル]
03/01/2024

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

構文

DWORD ResUtilFindLongProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPLONG      plPropertyValue
);

パラメーター

[in] pPropertyList

値を検索するプロパティリストへのポインター。

[in] cbPropertyListSize

pPropertyList に含まれるデータのサイズ (バイト単位)。

[in] pszPropertyName

検索する値の名前を含む null で終わる Unicode 文字列へのポインター。

[out] plPropertyValue

プロパティリストバッファーに格納されているデータの実際の値へのポインター。

戻り値

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

操作が失敗した場合、関数はシステムエラーコードを返します。考えられるエラーコードを次に示します。

リターンコード	説明
ERROR_INVALID_DATA	データの形式が正しくありません。
ERROR_FILE_NOT_FOUND	プロパティリストにプロパティを配置できませんでした。

注釈

操作が成功した場合、 plPropertyValue はプロパティリストバッファーに直接ポイントします。 plPropertyValue を使用する場合は、プロパティリストの書式設定を妨げないように注意してください。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム	Windows
ヘッダー	resapi.h
Library	ResUtils.lib
[DLL]	ResUtils.dll