Метод IWiaDrvItem::FindItemByName (wiamindr_lh.h)
Метод 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, optional]
Указывает на расположение памяти, которое получит адрес найденного элемента IWiaDrvItem .
Возвращаемое значение
Если метод выполняется успешно, он сохраняет указатель на найденный элемент в ppItem и возвращает S_OK. Если метод завершается сбоем, он помещает значение NULL в ppItem и возвращает S_FALSE. Если этот метод не находит необходимый элемент, он возвращает S_FALSE. Если во время поиска произошла ошибка, будет возвращен стандартный код com-ошибки.
Комментарии
Мини-драйверы вызывают этот метод, чтобы найти элемент в дереве элементов драйвера, когда известно полное имя элемента. Полное имя элемента получается в методе IWiaDrvItem::GetFullItemName.
Этот метод запускает поиск указанного элемента в корневом элементе дерева элементов драйвера.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wiamindr_lh.h (включая Wiamindr.h) |