Поделиться через


Метод IWiaDrvItem::FindChildItemByName (wiamindr_lh.h)

Метод IWiaDrvItem::FindChildItemByName выполняет поиск дерева элементов драйвера для определенного дочернего элемента.

Синтаксис

HRESULT FindChildItemByName(
  BSTR        __MIDL__IWiaDrvItem0010,
  IWiaDrvItem **__MIDL__IWiaDrvItem0011
);

Параметры

__MIDL__IWiaDrvItem0010

bstrChildItemName [in]

Указывает строку, содержащую имя с сведениями о пути для поиска дочернего элемента.

__MIDL__IWiaDrvItem0011

ppIChildItem [out, необязательный]

Указывает на расположение памяти, которое получит адрес найденного IWiaDrvItem дочерним элементом.

Возвращаемое значение

Если метод выполнен успешно, он сохраняет указатель на найденный дочерний элемент в ppIChildItem и возвращает S_OK. Если метод не удается найти дочерний элемент, он возвращает S_FALSE. Если метод завершается ошибкой по другой причине, он возвращает стандартный код ошибки COM.

Замечания

Мини-drivers обычно используют этот метод для поиска дерева элементов драйвера для определенного дочернего элемента, когда известно имя дочернего элемента. Полное имя дочернего элемента получено в методе IWiaDrvItem::GetFullItemName.

Требования

Требование Ценность
целевая платформа Настольный
заголовка wiamindr_lh.h (включить Wiamindr.h)

См. также

IWiaDrvItem

IWiaDrvItem::FindItemByName

IWiaDrvItem::GetFullItemName