Compartir a través de

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

  • Artículo

El método IWiaItem::FindItemByName busca en el árbol de elementos secundarios de un elemento con el nombre como clave de búsqueda. Cada objeto IWiaItem tiene un nombre como una de sus propiedades estándar.

Sintaxis

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

Parámetros

[in] lFlags

Tipo: LONG

Actualmente no se usa. Debe establecerse como cero.

[in] bstrFullItemName

Tipo: BSTR

Especifica el nombre del elemento para el que se va a buscar.

[out] ppIWiaItem

Tipo: IWiaItem**

Puntero a la interfaz IWiaItem .

Valor devuelto

Tipo: HRESULT

Este método devuelve S_OK si encuentra el elemento o S_FALSE si no encuentra el elemento. Si se produce un error en el método, devuelve un código de error COM estándar.

Comentarios

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

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wia_xp.h (incluya Wia.h)
Library Wiaguid.lib
Archivo DLL Wiaservc.dll