Método IWiaItem2::FindItemByName
Pesquisa a árvore de subitems de um item usando o nome como a chave de pesquisa.
Sintaxe
HRESULT FindItemByName(
[in] LONG lFlags,
[in] BSTR bstrFullItemName,
[out] IWiaItem2 **ppIWiaItem2
);
Parâmetros
-
lFlags [in]
-
Tipo: LONG
Atualmente não utilizado. Deve ser definido como zero.
-
bstrFullItemName [in]
-
Tipo: BSTR
Especifica o nome do item a ser pesquisado.
-
ppIWiaItem2 [out]
-
Tipo: IWiaItem2**
Recebe o endereço de um ponteiro para a interface IWiaItem2 do item encontrado.
Valor retornado
Tipo: HRESULT
Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .
Comentários
Esse método pesquisa a árvore de subitens do item atual usando o nome como a chave de pesquisa. Se IWiaItem2::FindItemByName encontrar o item especificado por bstrFullItemName, ele armazenará o endereço de um ponteiro para a interface IWiaItem2 do item no parâmetro ppIWiaItem2 .
Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro ppIWiaItem2 .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|