IPortableDeviceProperties::GetPropertyAttributes メソッド (portabledeviceapi.h)

  • [アーティクル]

GetPropertyAttributes メソッドは、デバイス上の指定されたオブジェクト プロパティの属性を取得します。

構文

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

パラメーター

[in] pszObjectID

クエリを実行するオブジェクトのオブジェクト ID を含む null で終わる文字列へのポインター。 デバイスを指定するには、 WPD_DEVICE_OBJECT_IDを使用します。

[in] Key

クエリを実行するプロパティを指定する REFPROPERTYKEY 。 GetSupportedProperties を呼び出すことで、サポートされているプロパティの一覧を取得できます。 Windows ポータブル デバイスで定義されているプロパティの一覧については、「 プロパティと属性」を参照してください。

[out] ppAttributes

取得したプロパティ属性を保持する IPortableDeviceValues インターフェイスへのポインターを受け取る変数のアドレス。 これらは PROPERTYKEY と値のペアであり、 PROPERTYKEY は プロパティであり、値のデータ型は特定のプロパティに依存します。 呼び出し元は、このインターフェイスが完了したら、このインターフェイスを解放する必要があります。 Windows ポータブル デバイスで定義されている属性は、[ プロパティと属性] ページにあります。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功し、すべての属性が正常に取得されました。
S_FALSE
 一部の属性値のみを取得できます。 それ以外のユーザーは、VT_ERROR 型の HRESULT 値を含めませんでした。
E_POINTER
 必要なポインター引数が NULL でした。

注釈

プロパティ属性は、プロパティのアクセス権、有効な値、およびその他の情報を記述します。 たとえば、プロパティのWPD_PROPERTY_ATTRIBUTE_CAN_DELETE値を False に設定すると、削除を防ぎ、有効な値の範囲を個々のエントリとして格納できます。

例

このメソッドの使用方法の例については、「 単一オブジェクトのプロパティの設定」を参照してください。

要件

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

こちらもご覧ください

IPortableDeviceProperties インターフェイス

単一オブジェクトのプロパティの設定

Content-Object プロパティの書き込み