IPortableDeviceCapabilities::GetFixedPropertyAttributes メソッド (portabledeviceapi.h)
GetFixedPropertyAttributes メソッドは、指定したプロパティと形式の標準プロパティ属性を取得します。 標準属性は、同じ形式のすべてのオブジェクトに対して同じ値を持つ属性です。 たとえば、あるデバイスでは、ユーザーがビデオ ファイル名を変更できない場合があります。このデバイスは、WMV 形式のオブジェクトに対して False の値を持つ WPD_PROPERTY_ATTRIBUTE_CAN_WRITE を返します。 形式に異なる値を持つ属性、または省略可能な属性は返されません。
構文
HRESULT GetFixedPropertyAttributes(
[in] REFGUID Format,
[in] REFPROPERTYKEY Key,
[out] IPortableDeviceValues **ppAttributes
);
パラメーター
[in] Format
目的のオブジェクトの形式を指定する REFGUID 。 GUID 値の形式については、「オブジェクトの形式」を参照してください。
[in] Key
属性を知りたいプロパティを指定する REFPROPERTYKEY 。 Windows ポータブル デバイスによって定義されたプロパティは、「 プロパティと属性」に一覧表示されます。
[out] ppAttributes
属性とその値を保持する IPortableDeviceValues インターフェイスへのポインターを受け取る変数のアドレス。 呼び出し元は、このインターフェイスの使用が完了したら、このインターフェイスを解放する必要があります。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
注釈
Format パラメーターのWPD_OBJECT_FORMAT_ALLを指定して、プロパティ属性の完全なセットを取得できます。
属性はプロパティを記述します。 属性の例としては、 WPD_PROPERTY_ATTRIBUTE_CAN_READ と WPD_PROPERTY_ATTRIBUTE_CAN_WRITEがあります。 このメソッドは、リソース属性を取得しません。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |