IPortableDeviceCapabilities::GetSupportedFormatProperties メソッド (portabledeviceapi.h)

  • [アーティクル]

GetSupportedFormatProperties メソッドは、デバイス上の指定した形式のオブジェクトでサポートされているプロパティを取得します。

構文

HRESULT GetSupportedFormatProperties(
  [in]  REFGUID                      Format,
  [out] IPortableDeviceKeyCollection **ppKeys
);

パラメーター

[in] Format

オブジェクトの形式を指定する REFGUID 。 Windows ポータブル デバイスで定義されている形式の一覧については、「 オブジェクトの形式」を参照してください。

[out] ppKeys

指定した形式でサポートされているプロパティを含む IPortableDeviceKeyCollection インターフェイスへのポインターを受け取る変数のアドレス。 Windows ポータブル デバイスで定義されているプロパティの一覧については、「 プロパティと属性」を参照してください。 呼び出し元は、このインターフェイスの使用が完了したら、このインターフェイスを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。

解説

Format パラメーターのWPD_OBJECT_FORMAT_ALLを指定して、プロパティ属性の完全なセットを取得できます。

オブジェクトに特定のプロパティに値が割り当てられない場合、またはプロパティが削除された場合、デバイスはプロパティを列挙するときにプロパティをまったく報告しない可能性があります。 別のデバイスが プロパティを報告する場合がありますが、空の文字列または値が 0 です。 この不整合を回避するために、このメソッドを呼び出して、特定のオブジェクトに設定できるすべてのプロパティを学習できます。

必要条件

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

関連項目

IPortableDeviceCapabilities インターフェイス

IPortableDeviceCapabilities::GetSupportedFormats