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 を呼び出します。 このメソッドでは、ミニドライバーは、WIA サービス コンテキスト パラメーター pWiasContext が指す項目の削除を試みます。 項目が正常に削除された場合、メソッドは S_OK を返し、デバイス エラー値パラメーター plDevErrVal を 0 に設定します。 デバイス エラーが発生した場合、メソッドはデバイス エラー値パラメーター plDevErrVal にE_FAILとデバイス固有のエラー値を返します。
WIA サービスは、このメソッドを呼び出す前に、次のことを確認します。
項目がルート項目ではありません。
アイテムがフォルダーの場合、子は含まれません。
アイテムのアクセス権によって削除が許可されます。
WIA サービスは、これらの条件を検証するため、ミニドライバーもそれらを検証する必要はありません。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | wiamindr_lh.h (Wiamindr.h を含む) |