Método IWiaDrvItem::FindItemByName (wiamindr_lh.h)

Artigo
02/07/2025

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 localizado.

__MIDL__IWiaDrvItem0008

lFlags [in]

Reservado. Definido como zero.

__MIDL__IWiaDrvItem0009

ppItem [out, opcional]

Aponta para um local de memória que receberá o endereço do item de IWiaDrvItem encontrado.

Valor de retorno

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.

Observações

Os minidrivers chamam esse método para localizar um item em uma árvore de itens de driver quando o nome completo do item é conhecido. O nome completo do item é obtido no método IWiaDrvItem::GetFullItemName.

Esse método inicia a pesquisa do item especificado no item raiz na árvore de itens do driver.