Método IWiaItem2::FindItemByName

Busca en el árbol de subelementos de un elemento con el nombre como clave de búsqueda.

Sintaxis

HRESULT FindItemByName(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrFullItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

Parámetros

lFlags [in]

Tipo: LONG

Actualmente no se usa. Debe establecerse como cero.

bstrFullItemName [in]

Tipo: BSTR

Especifica el nombre del elemento que se va a buscar.

ppIWiaItem2 [out]

Tipo: IWiaItem2**

Recibe la dirección de un puntero a la interfaz IWiaItem2 del elemento encontrado.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

Este método busca en el árbol del elemento actual de los subelementos con el nombre como clave de búsqueda. Si IWiaItem2::FindItemByName encuentra el elemento especificado por bstrFullItemName, almacena la dirección de un puntero a la interfaz IWiaItem2 del elemento en el parámetro ppIWiaItem2 .

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppIWiaItem2 .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wia.h
IDL	Wia.idl