Функция wiasGetContextFromName (wiamdef.h)

Статья
08/08/2023

Функция wiasGetContextFromName извлекает контекст элемента для имени элемента.

Синтаксис

HRESULT wiasGetContextFromName(
  [in]  BYTE *pWiasContext,
        LONG lFlags,
  [in]  BSTR bstrName,
  [out] BYTE **ppWiasContext
);

Параметры

[in] pWiasContext

Указатель на контекст элемента WIA.

lFlags

Зарезервировано для использования в системе и должно иметь значение 0.

[in] bstrName

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

[out] ppWiasContext

Указатель на расположение памяти, которое получает адрес контекста элемента WIA.

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

При успешном выполнении функция возвращает S_OK.

Если функция завершается сбоем, она возвращает стандартную ошибку COM или один из кодов ошибок WIA.

Эта функция ищет контексты элементов, свойство WIA_IPA_FULL_ITEM_NAME которых соответствует bstrName. Обратите внимание, что это свойство отличается от WIA_IPA_ITEM_NAME, которое не содержит сведений о пути.

Эта функция должна использоваться мини-драйверами, когда им нужно перейти из одного контекста элемента приложения в другой с учетом имени элемента. Имена элементов приложения поступают из соответствующих элементов драйвера, которые создает мини-диск, и имена.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	wiamdef.h (включая Wiamdef.h)
Библиотека	Wiaservc.lib
DLL	Wiaservc.dll

См. также раздел

wiasGetRootItem

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