Метод IWiaItem2::FindItemByName

Выполняет поиск в дереве подэлементов элемента, используя имя в качестве ключа поиска.

Синтаксис

HRESULT FindItemByName(
  [in]  LONG      lFlags,
  [in]  BSTR      bstrFullItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

Параметры

lFlags [in]

Тип: LONG

В настоящее время не используется. Значение должно быть равно нулю.

bstrFullItemName [in]

Тип: BSTR

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

ppIWiaItem2 [out]

Тип: IWiaItem2**

Получает адрес указателя на интерфейс IWiaItem2 найденного элемента.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод выполняет поиск в дереве вложенных элементов текущего элемента, используя имя в качестве ключа поиска. Если IWiaItem2::FindItemByName находит элемент, указанный bstrFullItemName, он сохраняет адрес указателя на интерфейс IWiaItem2 элемента в параметре ppIWiaItem2 .

Приложения должны вызывать метод IUnknown::Release для указателей интерфейса, которые они получают с помощью параметра ppIWiaItem2 .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Wia.h
IDL	Wia.idl