次の方法で共有

IWiaMiniDrv::d rvDeleteItem メソッド (wiamindr_lh.h)

  • [アーティクル]

IWiaMiniDrv::d rvDeleteItem メソッドは、現在のドライバー項目を削除します。

構文

HRESULT drvDeleteItem(
  BYTE *__MIDL__IWiaMiniDrv0053,
  LONG __MIDL__IWiaMiniDrv0054,
  LONG *__MIDL__IWiaMiniDrv0055
);

パラメーター

__MIDL__IWiaMiniDrv0053

lFlags [in]

引っ込み思案。

__MIDL__IWiaMiniDrv0054

pWiasContext [in]

WIA 項目コンテキストへのポインター。

__MIDL__IWiaMiniDrv0055

plDevErrVal [out]

このメソッドの状態コードを受け取るメモリの場所を指します。 このメソッドがS_OKを返す場合、格納される値は 0 になります。 それ以外の場合、ミニドライバー固有のエラー コードは、このパラメーターが指す場所に格納されます。

戻り値

成功した場合、メソッドは S_OK を返し、plDevErrVal によって指デバイス エラー値をクリアする必要があります。 メソッドが失敗した場合は、標準の COM エラー コードを返し、plDevErrVal によって指されるメモリにミニドライバー固有のエラー コード値配置する必要があります。 plDevErrVal 指す値は、IWiaMiniDrv::d rvGetDeviceErrorStr 呼び出すことによって、文字列に変換できます。

備考

ドライバー項目を削除するために、WIA サービスは IWiaMiniDrv::d rvDeleteItem ミニドライバー メソッドを呼び出します。 このメソッドでは、ミニドライバーは、pWiasContext WIA サービス コンテキスト パラメーターによって指される項目の削除を試みます。 項目が正常に削除された場合、メソッドは S_OK を返し、plDevErrVal デバイス エラー値パラメーターを 0 に設定します。 デバイス エラーが発生した場合、このメソッドは plDevErrVal E_FAIL およびデバイス固有のエラー値デバイスエラー値パラメーターを返します。

WIA サービスは、このメソッドを呼び出す前に、次のことを確認します。

  • 項目がルート項目ではありません。

  • アイテムがフォルダーの場合、子はありません。

  • アイテムのアクセス権によって削除が許可されます。

WIA サービスはこれらの条件を検証するため、ミニドライバーも検証する必要はありません。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー wiamindr_lh.h (Wiamindr.h を含む)

関連項目

IWiaMiniDrv の

IWiaMiniDrv::d rvGetDeviceErrorStr