Método IWiaDrvItem::FindItemByName (wiamindr_lh.h)
El método IWiaDrvItem::FindItemByName busca un elemento en un árbol de elementos de controlador por el nombre completo del elemento.
Sintaxis
HRESULT FindItemByName(
LONG __MIDL__IWiaDrvItem0007,
BSTR __MIDL__IWiaDrvItem0008,
IWiaDrvItem **__MIDL__IWiaDrvItem0009
);
Parámetros
__MIDL__IWiaDrvItem0007
bstrFullItemName [in]
Especifica el nombre completo del elemento que se va a buscar.
__MIDL__IWiaDrvItem0008
lFlags [in]
Reservado. Establézcalo en cero.
__MIDL__IWiaDrvItem0009
ppItem [out, opcional]
Apunta a una ubicación de memoria que recibirá la dirección del elemento IWiaDrvItem encontrado.
Valor devuelto
Si el método se ejecuta correctamente, almacena un puntero al elemento encontrado en ppItem y devuelve S_OK. Si se produce un error en el método, coloca NULL en ppItem y devuelve S_FALSE. Si este método no encuentra el elemento necesario, devuelve S_FALSE. Si se produjo un error durante la búsqueda, se devolverá un código de error COM estándar.
Observaciones
Los minidrivers llaman a este método para buscar un elemento en un árbol de elementos de controlador cuando se conoce el nombre completo del elemento. El nombre completo del elemento se obtiene en el método IWiaDrvItem::GetFullItemName.
Este método inicia la búsqueda del elemento especificado en el elemento raíz del árbol de elementos del controlador.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wiamindr_lh.h (incluya Wiamindr.h) |