IWiaDrvItem::UnlinkItemTree メソッド (wiamindr_lh.h)

IWiaDrvItem::UnlinkItemTree メソッドは、ドライバー項目ツリーのリンクを解除し、ツリー内のすべての項目を解放します。

構文

HRESULT UnlinkItemTree(
  LONG __MIDL__IWiaDrvItem0005
);

__MIDL__IWiaDrvItem0005

lFlags [in]

ドライバー項目ツリーのリンクを解除する方法を示します。このパラメーターは、次のいずれかの値に設定する必要があります。

値	説明
WiaItemTypeDeleted	項目はツリーから削除済みとしてマークされます。
WiaItemTypeDisconnected	項目は、切断されたデバイスを表します。

詳細については、「 WIA 項目の種類フラグ」を参照してください。

メソッドが成功すると、 S_OKが返されます。ルート以外の項目でメソッドが呼び出されると、 E_INVALIDARGが返されます。メソッドが別の理由で失敗した場合は、標準の COM エラーコードが返されます。

ミニドライバーは、ツリーを無効にする場合に、ドライバー項目ツリーのルート項目でこのメソッドを呼び出す必要があります。これは通常、ドライバーがアンロードされている場合、またはミニドライバーがドライバー項目ツリーを再構築する必要がある場合に行われます。

要件	値
対象プラットフォーム	デスクトップ
Header	wiamindr_lh.h (Wiamindr.h を含む)