Método IWiaDrvItem::UnlinkItemTree (wiamindr_lh.h)
O método IWiaDrvItem::UnlinkItemTree desvincula a árvore de itens do driver e libera todos os itens na árvore.
Sintaxe
HRESULT UnlinkItemTree(
LONG __MIDL__IWiaDrvItem0005
);
Parâmetros
__MIDL__IWiaDrvItem0005
lFlags [in]
Indica como a árvore de itens do driver deve ser desvinculada. Esse parâmetro deve ser definido como um dos valores a seguir.
| Valor | Descrição |
|---|---|
| WiaItemTypeDeleted | O item é marcado como excluído da árvore. |
| WiaItemTypeDisconnected | O item representa um dispositivo desconectado. |
Para obter mais informações, consulte Sinalizadores de tipo de item WIA.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Se o método for chamado em um item não padrão, ele retornará E_INVALIDARG. Se o método falhar por outro motivo, ele retornará um código de erro COM padrão.
Comentários
Os minidrivers devem chamar esse método no item raiz na árvore de itens do driver quando quiserem invalidar a árvore. Normalmente, isso é feito quando o driver está sendo descarregado ou quando o minidriver precisa recriar a árvore de itens do driver.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |