IPNPXDeviceAssociation::D elete メソッド (pnpxassoc.h)

[関数の検出は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。

アソシエーション データベースからエントリを削除し、適切な通知を送信します。

構文

HRESULT Delete(
  [in, optional] const WCHAR                    *pszSubcategory,
  [in]           IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification
);

パラメーター

[in, optional] pszSubcategory

エントリが格納されるアソシエーション データベースのサブカテゴリ。 このパラメーターは、NULL でもかまいません。

[in] pIFunctionDiscoveryNotification

関数の検出を使用した通知に登録されている IFunctionDiscoveryNotification オブジェクト。

戻り値

可能な戻り値は次のとおりですが、これらに限定されません。

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

注釈

このメソッドは、 IPNPXDeviceAssociation インターフェイスの取得元の関数インスタンスに対応する関連付けデータベース エントリを変更します。

通知に使用されるコールバック メソッドを決定するには、次のロジックを使用します。

• デバイスが削除された後に PnP 通知を受信した場合、enumQueryUpdateAction パラメーターを QUA_REMOVE に設定して IFunctionDiscoveryNotification::OnUpdate メソッドが呼び出されます。
• デバイスが削除された後に PnP 通知を受信せず、保留中の PnP イベントがない場合は、 IFunctionDiscoveryNotification::OnError メソッドが呼び出されます。
• 最後に、デバイスが削除された後に PnP 通知を受信せず、保留中の PnP イベントがある場合、コールバック メソッドは呼び出されません。

関連付けデータベース エントリを削除せずにデバイスを使用不可としてマークするには、 IPNPXDeviceAssociation::Unassociate を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	pnpxassoc.h

こちらもご覧ください

IPNPXAssociation::D elete

IPNPXDeviceAssociation