ResUtilFindExpandedSzProperty 関数 (resapi.h)

[アーティクル]
08/25/2023

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

構文

DWORD ResUtilFindExpandedSzProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPWSTR      *pszPropertyValue
);

パラメーター

[in] pPropertyList

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

[in] cbPropertyListSize

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

[in] pszPropertyName

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

[out, optional] pszPropertyValue

プロパティ値のコピーを含むバッファー (関数によって割り当てられる) への WCHAR ポインターへのポインター。割り当てられたメモリを解放するには、 LocalFree (*pszPropertyValue) を呼び出す必要があります。値が必要ない場合は、このパラメーターに NULL を 渡します。

戻り値

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

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

リターンコード	説明
ERROR_INVALID_DATA	プロパティリストの書式が正しくありません。
ERROR_NOT_ENOUGH_MEMORY	関数は、プロパティ値を返すバッファーを割り当てませんでした。
ERROR_FILE_NOT_FOUND	指定したプロパティをプロパティリストに配置できませんでした。

注釈

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

要件

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