Метод IWiaItem::FindItemByName (wia_xp.h)

Метод IWiaItem::FindItemByName выполняет поиск в дереве вложенных элементов элемента, используя имя в качестве ключа поиска. Каждый объект IWiaItem имеет имя в качестве одного из своих стандартных свойств.

Синтаксис

HRESULT FindItemByName(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

Параметры

[in] lFlags

Тип: LONG

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

[in] bstrFullItemName

Тип: BSTR

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

[out] ppIWiaItem

Тип: IWiaItem**

Указатель на интерфейс IWiaItem .

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

Тип: HRESULT

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

Комментарии

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wia_xp.h (включая Wia.h)
Библиотека	Wiaguid.lib
DLL	Wiaservc.dll