ResUtilFindMultiSzProperty 関数 (resapi.h)

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

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

構文

DWORD ResUtilFindMultiSzProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPWSTR      *pszPropertyValue,
  [out] LPDWORD     pcbPropertyValueSize
);

パラメーター

[in] pPropertyList

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

[in] cbPropertyListSize

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

[in] pszPropertyName

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

[out] pszPropertyValue

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

[out] pcbPropertyValueSize

返される値のサイズ (バイト単位) へのポインター。サイズが必要ない場合は、このパラメーターに NULL を 渡します。

戻り値

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

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

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

注釈

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

要件

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