IPortableDeviceResources::GetResourceAttributes メソッド (portabledeviceapi.h)

GetResourceAttributes メソッドは、オブジェクト内の指定されたリソースからすべての属性を取得します。

構文

HRESULT GetResourceAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppResourceAttributes
);

パラメーター

[in] pszObjectID

リソースをホストしているオブジェクトのオブジェクト ID を含む null で終わる文字列へのポインター。

[in] Key

クエリするリソースを指定する REFPROPERTYKEY 。

[out] ppResourceAttributes

各属性とその値をそれぞれ記述する PROPERTYKEY/PROPVARIANT ペアを保持する IPortableDeviceValues インターフェイス ポインターへのポインター。 属性値の値の型は異なります。 プロパティを返すことができなければ、返されたプロパティの値が VT_ERRORされ、 PROPVARIANTscode メンバーにはその特定のエラーの HRESULT が含まれます。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	すべての属性値が取得されました。
S_FALSE	1 つ以上の属性値を取得できませんでした。 これらは、取得した ppResourceAttributes パラメーターにVT_ERROR型の HRESULT 値を持ちます。
E_POINTER	必要なポインター引数の少なくとも 1 つが NULL でした。

注釈

リソース属性は、リソースに関連するアクセス権、サイズ、形式、およびその他の情報を記述します。 たとえば、イメージ オブジェクトのオーディオ注釈リソースの属性では、オーディオのビット レート、チャネル数、データ形式を指定できます。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

こちらもご覧ください

IPortableDeviceResources インターフェイス