IPropertyStorage::ReadMultiple メソッド (propidl.h)

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

ReadMultiple メソッドは、現在のプロパティセットから指定されたプロパティを読み取ります。

構文

HRESULT ReadMultiple(
  [in]  ULONG             cpspec,
  [in]  const PROPSPEC [] rgpspec,
  [out] PROPVARIANT []    rgpropvar
);

パラメーター

[in] cpspec

rgpspec 配列で指定するプロパティの数値カウント。このパラメーターの値は 0 に設定できます。ただし、 rgpspec で設定された値に関係なく、プロパティが読み取られたため、メソッドの目的を打ち負かします。

[in] rgpspec

PROPSPEC 構造体の配列は、読み取るプロパティを指定します。プロパティは、プロパティ ID またはオプションの文字列名のいずれかで指定できます。配列内に特定の順序でプロパティを指定する必要はありません。配列には重複するプロパティを含めることができます。その結果、単純なプロパティの場合は戻り時にプロパティ値が重複します。 Nonsimple プロパティは、2 回目に開こうとしたときにアクセス拒否を返す必要があります。配列には、プロパティ ID と文字列 ID を混在させることができます。

[out] rgpropvar

戻り値として、rgpspec 配列内の対応する要素によって指定されたプロパティの値を格納する PROPVARIANT 構造体の呼び出し元によって割り当てられた配列。配列は、PROPVARIANT 構造体の cpspec パラメーターの値を保持するのに十分な大きさである必要があります。 cpspec パラメーターは、配列に設定されたプロパティの数を指定します。呼び出し元は、これらの PROPVARIANT 構造体値を特定の順序で初期化する必要はありません。ただし、実装では、戻り時にすべてのメンバーを正しく入力する必要があります。その他の適切な値がない場合、実装では、各 PROPVARIANT 構造体の vt メンバーを VT_EMPTYに設定する必要があります。

戻り値

このメソッドは、標準の戻り値 E_UNEXPECTEDと、次の値をサポートします。

この関数は、 HRESULT データ型でラップされたファイルシステムエラーまたは Win32 エラーを返すこともできます。詳細については、「エラー処理戦略」を参照してください。

詳細については、「プロパティストレージに関する考慮事項」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	propidl.h (Objbase.h、Propidlbase.h を含む)
Library	Uuid.lib
[DLL]	Ole32.dll