Compartilhar via

Método IWiaItem::FindItemByName (wia_xp.h)

  • Artigo

O método IWiaItem::FindItemByName pesquisa a árvore de subitens de um item usando o nome como a chave de pesquisa. Cada objeto IWiaItem tem um nome como uma de suas propriedades padrão.

Sintaxe

HRESULT FindItemByName(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

Parâmetros

[in] lFlags

Tipo: LONG

Atualmente não utilizado. Deve ser definido como zero.

[in] bstrFullItemName

Tipo: BSTR

Especifica o nome do item para o qual pesquisar.

[out] ppIWiaItem

Tipo: IWiaItem**

Ponteiro para a interface IWiaItem .

Retornar valor

Tipo: HRESULT

Esse método retornará S_OK se encontrar o item ou S_FALSE se ele não encontrar o item. Se o método falhar, ele retornará um código de erro COM padrão.

Comentários

Esse método pesquisa a árvore de subitens do item atual usando o nome como a chave de pesquisa. Se IWiaItem::FindItemByName encontrar o item especificado por bstrFullItemName, ele armazenará o endereço de um ponteiro para a interface IWiaItem do item no parâmetro ppIWiaItem .

Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro ppIWiaItem .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wia_xp.h (inclua Wia.h)
Biblioteca Wiaguid.lib
DLL Wiaservc.dll