IPropertyStorage::ReadPropertyNames メソッド (propidlbase.h)
ReadPropertyNames メソッドは、指定されたプロパティ ID の既存の文字列名を取得します。
構文
HRESULT ReadPropertyNames(
[in] ULONG cpropid,
[in] const PROPID [] rgpropid,
[in, out] LPOLESTR [] rglpwstrName
);
パラメーター
[in] cpropid
配列 rgpropid の入力に対する要素の数。 このパラメーターの値は 0 に設定できますが、プロパティ名が読み取られるので、このメソッドの目的を損ないます。
[in] rgpropid
名前を取得するプロパティ ID の配列。
[in, out] rglpwstrName
LPWSTR メンバーのサイズ cpropid の呼び出し元によって割り当てられた配列。 戻り値の場合、実装はこの配列を埋めます。 指定されたエントリには、プロパティ ID の対応する文字列名が含まれます。または、プロパティ ID に文字列名がない場合は空にすることができます。
配列の各 LPWSTR メンバーは、 CoTaskMemFree 関数を使用して解放する必要があります。
戻り値
このメソッドは、次に加えて、標準の戻り値E_UNEXPECTEDをサポートしています。
解説
rgpropid 配列で指定されたプロパティ ID のリスト内の各プロパティ ID について、ReadPropertyNames は対応する文字列名がある場合は、対応する文字列名を取得します。 文字列名は、プロパティの作成時に IPropertyStorage::WriteMultiple の呼び出しで名前を指定するか、 IPropertyStorage::WritePropertyNames を呼び出すことによって作成されます。 どちらの場合も、文字列名は省略可能ですが、すべてのプロパティにプロパティ ID が必要です。
プロパティ ID にマップされる文字列名は、セット内で一意である必要があります。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | propidlbase.h (Objbase.h、Propidlbase.h を含む) |
| Library | Uuid.lib |
| [DLL] | Ole32.dll |