Metode IWiaMiniDrv::d rvDeleteItem (wiamindr_lh.h)
Metode IWiaMiniDrv::d rvDeleteItem menghapus item driver saat ini.
Sintaks
HRESULT drvDeleteItem(
BYTE *__MIDL__IWiaMiniDrv0053,
LONG __MIDL__IWiaMiniDrv0054,
LONG *__MIDL__IWiaMiniDrv0055
);
Parameter
__MIDL__IWiaMiniDrv0053
lFlags [in]
Dicadangkan.
__MIDL__IWiaMiniDrv0054
pWiasContext [in]
Arahkan ke konteks item WIA.
__MIDL__IWiaMiniDrv0055
plDevErrVal [out]
Menunjuk ke lokasi memori yang akan menerima kode status untuk metode ini. Jika metode ini mengembalikan S_OK, nilai yang disimpan akan menjadi nol. Jika tidak, kode kesalahan khusus minidriver akan disimpan di lokasi yang ditujukkan oleh parameter ini.
Mengembalikan nilai
Jika berhasil, metode harus mengembalikan S_OK dan menghapus nilai kesalahan perangkat yang ditunjukkan oleh plDevErrVal. Jika metode gagal, metode harus mengembalikan kode kesalahan COM standar dan menempatkan nilai kode kesalahan khusus minidriver dalam memori yang ditunjukkan oleh plDevErrVal. Nilai yang ditujukkan oleh plDevErrVal dapat dikonversi ke string dengan memanggil IWiaMiniDrv::d rvGetDeviceErrorStr.
Keterangan
Untuk menghapus item driver, layanan WIA akan memanggil metode minidriver IWiaMiniDrv::d rvDeleteItem. Dalam metode ini, minidriver akan mencoba menghapus item yang ditujukkan oleh parameter konteks layanan WIA pWiasContext. Jika item berhasil dihapus, metode mengembalikan S_OK dan mengatur parameter nilai kesalahan perangkat plDevErrVal ke nol. Jika terjadi kesalahan perangkat, metode mengembalikan E_FAIL dan nilai kesalahan khusus perangkat dalam parameter nilai kesalahan perangkat plDevErrVal.
Sebelum layanan WIA memanggil metode ini, layanan ini memverifikasi hal berikut:
Item bukan item akar.
Jika item adalah folder, item tidak memiliki turunan.
Hak akses item memungkinkan penghapusan.
Karena layanan WIA memverifikasi kondisi ini, tidak perlu bagi minidriver untuk juga memverifikasinya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamindr_lh.h (termasuk Wiamindr.h) |