функция wiasReadPropStr (wiamdef.h)
Функция wiasReadPropStr извлекает строковое значение свойства из элемента WIA.
Синтаксис
HRESULT wiasReadPropStr(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BSTR *pbstr,
[out, optional] BSTR *pbstrOld,
BOOL bMustExist
);
Параметры
[in] pWiasContext
Указатель на контекст элемента WIA.
propid
Указывает идентификатор свойства.
[out] pbstr
Указатель на расположение памяти, которое получает первый байт строкового значения свойства.
[out, optional] pbstrOld
Указатель на расположение памяти, которое получает первый байт предыдущего значения свойства. Если эти сведения не нужны, задайте для этого параметра значение NULL.
bMustExist
Указывает, должно ли существовать свойство. Если задано значение TRUE, свойство должно существовать; Если задано значение FALSE, свойство не обязательно существует.
Возвращаемое значение
При успешном выполнении функция возвращает S_OK. Если функция завершается ошибкой, она возвращает стандартную ошибку COM или одну из WIA_ERROR_XXX ошибок (описанную в документации по пакету SDK для Microsoft Windows).
Замечания
После завершения мини-driver с помощью строки, полученной из этой функции, она должна освободить память, используемую для строки.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows Me и Windows XP и более поздних версиях операционных систем Windows. |
| целевая платформа | Настольный |
| заголовка | wiamdef.h (включая Wiamdef.h) |
| библиотеки | Wiaservc.lib |
| DLL | Wiaservc.dll |