Метод 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, то сохраненное значение будет равно нулю. В противном случае код ошибки для мини-driver будет храниться в расположении, на которое указывает этот параметр.
Возвращаемое значение
При успешном выполнении метод должен возвращать S_OK и очищать значение ошибки устройства, указываемое на plDevErrVal. Если метод завершается ошибкой, он должен вернуть стандартный код ошибки COM и поместить значение кода ошибки для мини-driver в память, на которую указывает plDevErrVal. Значение, указываемое plDevErrVal, можно преобразовать в строку путем вызова IWiaMiniDrv::d rvGetDeviceErrorStr.
Замечания
Чтобы удалить элемент драйвера, служба WIA вызовет метод minidriver IWiaMiniDrv::d rvDeleteItem. В этом методе мини-driver попытается удалить элемент, на который указывает параметр контекста службы WIA, pWiasContext. Если элемент успешно удален, метод возвращает S_OK и задает параметр значения ошибки устройства plDevErrVal равным нулю. Если произошла ошибка устройства, метод возвращает E_FAIL и значение ошибки для конкретного устройства в параметре значения ошибки устройства plDevErrVal.
Прежде чем служба WIA вызывает этот метод, он проверяет следующее:
Элемент не является корневым элементом.
Если элемент является папкой, у него нет дочерних элементов.
Права доступа элемента разрешают удаление.
Так как служба WIA проверяет эти условия, не требуется для мини-driver, чтобы также проверить их.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | wiamindr_lh.h (включить Wiamindr.h) |