Método IWiaMiniDrv::d rvDeleteItem (wiamindr_lh.h)
O método IWiaMiniDrv::d rvDeleteItem exclui o item de driver atual.
Sintaxe
HRESULT drvDeleteItem(
BYTE *__MIDL__IWiaMiniDrv0053,
LONG __MIDL__IWiaMiniDrv0054,
LONG *__MIDL__IWiaMiniDrv0055
);
Parâmetros
__MIDL__IWiaMiniDrv0053
lFlags [in]
Reservado.
__MIDL__IWiaMiniDrv0054
pWiasContext [in]
Ponteiro para um contexto de item WIA.
__MIDL__IWiaMiniDrv0055
plDevErrVal [out]
Aponta para um local de memória que receberá um código status para esse método. Se esse método retornar S_OK, o valor armazenado será zero. Caso contrário, um código de erro específico do minidriver será armazenado no local apontado por esse parâmetro.
Retornar valor
Em caso de êxito, o método deve retornar S_OK e limpar o valor de erro do dispositivo apontado por plDevErrVal. Se o método falhar, ele deverá retornar um código de erro COM padrão e colocar um valor de código de erro específico do minidriver na memória apontada por plDevErrVal. O valor apontado por plDevErrVal pode ser convertido em uma cadeia de caracteres chamando IWiaMiniDrv::d rvGetDeviceErrorStr.
Comentários
Para excluir um item de driver, o serviço WIA chamará o método minidriver IWiaMiniDrv::d rvDeleteItem. Nesse método, o minidriver tentará excluir o item apontado pelo parâmetro de contexto do serviço WIA pWiasContext. Se o item for excluído com êxito, o método retornará S_OK e definirá o parâmetro de valor de erro do dispositivo plDevErrVal como zero. Se ocorrer um erro de dispositivo, o método retornará E_FAIL e um valor de erro específico do dispositivo no parâmetro de valor de erro do dispositivo plDevErrVal.
Antes que o serviço WIA chame esse método, ele verifica o seguinte:
O item não é o item raiz.
Se o item for uma pasta, ele não terá filhos.
Os direitos de acesso do item permitem a exclusão.
Como o serviço WIA verifica essas condições, não é necessário que o minidriver também as verifique.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |