ResUtilFindBinaryProperty 関数 (resapi.h)

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

プロパティリスト内の指定されたバイナリプロパティを検索し、プロパティの値を返すこともできます。 PRESUTIL_FIND_BINARY_PROPERTY型は、この関数へのポインターを定義します。

構文

DWORD ResUtilFindBinaryProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPBYTE      *pbPropertyValue,
  [out, optional] LPDWORD     pcbPropertyValueSize
);

パラメーター

[in] pPropertyList

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

[in] cbPropertyListSize

pPropertyList で指定されたプロパティリストのサイズ (バイト単位)。

[in] pszPropertyName

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

[out, optional] pbPropertyValue

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

[out, optional] pcbPropertyValueSize

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

戻り値

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

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

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

注釈

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

要件

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