IPortableDeviceProperties::D elete メソッド (portabledeviceapi.h)

  • [アーティクル]

Delete メソッドは、デバイス上の指定したオブジェクトから指定したプロパティを削除します。

構文

HRESULT Delete(
  [in] LPCWSTR                      pszObjectID,
  [in] IPortableDeviceKeyCollection *pKeys
);

パラメーター

[in] pszObjectID

プロパティを削除するオブジェクトの ID を指定する null で終わる文字列へのポインター。 デバイスを指定するには、 WPD_DEVICE_OBJECT_IDを使用します。

[in] pKeys

削除するプロパティを指定する IPortableDeviceKeyCollection インターフェイスへのポインター。 Windows ポータブル デバイスで定義されているプロパティの一覧については、「 プロパティと属性」を参照してください。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
S_FALSE
 1 つ以上のプロパティ値を削除できませんでした。
E_POINTER
 必要なポインター引数が NULL でした。

注釈

プロパティは、WPD_PROPERTY_ATTRIBUTE_CAN_DELETE属性が True の場合にのみ削除できます。 この属性は、 GetPropertyAttributes を呼び出すことによって取得できます。

ドライバーには、部分的な成功を示す方法はありません。つまり、一部のプロパティのみを削除できる場合、ドライバーは S_FALSEを返しますが、このメソッドは正常に削除されたプロパティを示しません。 削除されたプロパティを確認する唯一の方法は、 IPortableDeviceProperties::GetValues を呼び出してすべてのプロパティを要求することです。

要件

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

こちらもご覧ください

IPortableDeviceProperties インターフェイス