Método IWiaDrvItem::FindChildItemByName (wiamindr_lh.h)
O método IWiaDrvItem::FindChildItemByName pesquisa na árvore de itens do driver um item filho específico.
Sintaxe
HRESULT FindChildItemByName(
BSTR __MIDL__IWiaDrvItem0010,
IWiaDrvItem **__MIDL__IWiaDrvItem0011
);
Parâmetros
__MIDL__IWiaDrvItem0010
bstrChildItemName [in]
Especifica uma cadeia de caracteres que contém o nome com informações de caminho do item filho a ser encontrado.
__MIDL__IWiaDrvItem0011
ppIChildItem [out, opcional]
Aponta para um local de memória que receberá o endereço do item filho IWiaDrvItem encontrado.
Retornar valor
Se o método for bem-sucedido, ele armazenará um ponteiro para o item filho encontrado em ppIChildItem e retornará S_OK. Se o método não encontrar o item filho, ele retornará S_FALSE. Se o método falhar por outro motivo, ele retornará um código de erro COM padrão.
Comentários
Os minidrivers normalmente usam esse método para pesquisar em uma árvore de itens de driver um item filho específico quando o nome do item filho é conhecido. O nome completo do item filho é obtido no método IWiaDrvItem::GetFullItemName.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |