Método IWiaDrvItem::FindChildItemByName (wiamindr_lh.h)
El método IWiaDrvItem::FindChildItemByName busca en el árbol de elementos del controlador un elemento secundario específico.
Sintaxis
HRESULT FindChildItemByName(
BSTR __MIDL__IWiaDrvItem0010,
IWiaDrvItem **__MIDL__IWiaDrvItem0011
);
Parámetros
__MIDL__IWiaDrvItem0010
bstrChildItemName [in]
Especifica una cadena que contiene el nombre con información de ruta de acceso del elemento secundario que se va a buscar.
__MIDL__IWiaDrvItem0011
ppIChildItem [out, optional]
Apunta a una ubicación de memoria que recibirá la dirección del elemento secundario IWiaDrvItem encontrado.
Valor devuelto
Si el método se realiza correctamente, almacena un puntero al elemento secundario encontrado en ppIChildItem y devuelve S_OK. Si el método no encuentra el elemento secundario, devuelve S_FALSE. Si se produce un error en el método por otro motivo, devuelve un código de error COM estándar.
Comentarios
Los minidrivers suelen usar este método para buscar un árbol de elementos de controlador para un elemento secundario específico cuando se conoce el nombre del elemento secundario. El nombre completo del elemento secundario se obtiene en el método IWiaDrvItem::GetFullItemName.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wiamindr_lh.h (incluya Wiamindr.h) |