функция wiasGetContextFromName (wiamdef.h)
Функция 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, который не содержит сведения о пути.
Эта функция должна использоваться мини-drivers, если им нужно перейти из одного контекста элемента приложения в другой, учитывая имя элемента. Имена элементов приложения поступают из соответствующих элементов драйвера, которые создает мини-driver и имена.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | wiamdef.h (включая Wiamdef.h) |
| библиотеки | Wiaservc.lib |
| DLL | Wiaservc.dll |