Método IWiaDrvItem::FindItemByName (wiamindr_lh.h)
O método IWiaDrvItem::FindItemByName localiza um item em uma árvore de itens de driver pelo nome completo do item.
Sintaxe
HRESULT FindItemByName(
LONG __MIDL__IWiaDrvItem0007,
BSTR __MIDL__IWiaDrvItem0008,
IWiaDrvItem **__MIDL__IWiaDrvItem0009
);
Parâmetros
__MIDL__IWiaDrvItem0007
bstrFullItemName [in]
Especifica o nome completo do item a ser encontrado.
__MIDL__IWiaDrvItem0008
lFlags [in]
Reservado. Defina como zero.
__MIDL__IWiaDrvItem0009
ppItem [out, opcional]
Aponta para um local de memória que receberá o endereço do item IWiaDrvItem encontrado.
Retornar valor
Se o método for bem-sucedido, ele armazenará um ponteiro para o item encontrado em ppItem e retornará S_OK. Se o método falhar, ele colocará NULL em ppItem e retornará S_FALSE. Se esse método não encontrar o item necessário, ele retornará S_FALSE. Se ocorrer um erro durante a pesquisa, um código de erro COM padrão será retornado.
Comentários
Os minidrivers chamam esse método para encontrar um item em uma árvore de itens do driver quando o nome completo do item for conhecido. O nome completo do item é obtido no método IWiaDrvItem::GetFullItemName.
Esse método inicia a pesquisa pelo item especificado no item raiz na árvore de itens do driver.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |