ResUtilFindSzProperty 関数 (resapi.h)
プロパティ リスト内の文字列プロパティを検索 します。 PRESUTIL_FIND_SZ_PROPERTY型は、この関数へのポインターを定義します。
構文
DWORD ResUtilFindSzProperty(
[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を返します。
操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードを次に示します。
| リターン コード | 説明 |
|---|---|
|
プロパティ リストの書式が正しくありません。 |
|
関数は、プロパティ値を返すバッファーを割り当てませんでした。 |
|
指定したプロパティをプロパティ リストに配置できませんでした。 |
解説
ResUtilFindSzProperty が成功した場合、*pszPropertyValue は pPropertyList に格納されているデータのコピーを指します。 メモリ リークを防ぐために、必ず *pszPropertyValue で LocalFree を呼び出してください。
要件
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | resapi.h |
| Library | ResUtils.lib |
| [DLL] | ResUtils.dll |