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

Статья
02/07/2025

Метод IWiaDrvItem::FindItemByName находит элемент в дереве элементов драйвера по полному имени элемента.

Синтаксис

HRESULT FindItemByName(
  LONG        __MIDL__IWiaDrvItem0007,
  BSTR        __MIDL__IWiaDrvItem0008,
  IWiaDrvItem **__MIDL__IWiaDrvItem0009
);

Параметры

__MIDL__IWiaDrvItem0007

bstrFullItemName [in]

Указывает полное имя элемента для поиска.

__MIDL__IWiaDrvItem0008

lFlags [in]

Скрытный. Установите значение нулю.

__MIDL__IWiaDrvItem0009

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

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

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

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

Замечания

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

Этот метод запускает поиск указанного элемента в корневом элементе в дереве элементов драйвера.