Método IWiaMiniDrv::d rvDeleteItem (wiamindr_lh.h)
El método IWiaMiniDrv::d rvDeleteItem elimina el elemento de controlador actual.
Sintaxis
HRESULT drvDeleteItem(
BYTE *__MIDL__IWiaMiniDrv0053,
LONG __MIDL__IWiaMiniDrv0054,
LONG *__MIDL__IWiaMiniDrv0055
);
Parámetros
__MIDL__IWiaMiniDrv0053
lFlags [in]
Reservado.
__MIDL__IWiaMiniDrv0054
pWiasContext [in]
Puntero a un contexto de elemento WIA.
__MIDL__IWiaMiniDrv0055
plDevErrVal [out]
Apunta a una ubicación de memoria que recibirá un código de estado para este método. Si este método devuelve S_OK, el valor almacenado será cero. De lo contrario, se almacenará un código de error específico del minidriver en la ubicación a la que apunta este parámetro.
Valor devuelto
Si se ejecuta correctamente, el método debe devolver S_OK y borrar el valor de error del dispositivo al que apunta plDevErrVal. Si se produce un error en el método, debe devolver un código de error COM estándar y colocar un valor de código de error específico del minidriver en la memoria a la que apunta plDevErrVal. El valor al que apunta plDevErrVal se puede convertir en una cadena llamando a IWiaMiniDrv::d rvGetDeviceErrorStr.
Observaciones
Para eliminar un elemento de controlador, el servicio WIA llamará al método minidriver IWiaMiniDrv::d rvDeleteItem. En este método, el minidriver intentará eliminar el elemento al que apunta el parámetro de contexto del servicio WIA pWiasContext. Si el elemento se elimina correctamente, el método devuelve S_OK y establece el parámetro de valor de error del dispositivo plDevErrVal en cero. Si se produce un error de dispositivo, el método devuelve E_FAIL y un valor de error específico del dispositivo en el parámetro de valor de error del dispositivo plDevErrVal.
Antes de que el servicio WIA llame a este método, comprueba lo siguiente:
El elemento no es el elemento raíz.
Si el elemento es una carpeta, no tiene ningún elemento secundario.
Los derechos de acceso del elemento permiten la eliminación.
Dado que el servicio WIA comprueba estas condiciones, no es necesario que el minidriver también los compruebe.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wiamindr_lh.h (incluya Wiamindr.h) |