функция wiasReadPropBin (wiamdef.h)
Функция wiasReadPropBin извлекает значение свойства двоичного данных из элемента WIA.
Синтаксис
HRESULT wiasReadPropBin(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BYTE **ppbVal,
[out, optional] BYTE **ppbValOld,
BOOL bMustExist
);
Параметры
[in] pWiasContext
Указатель на контекст элемента WIA.
propid
Указывает идентификатор свойства.
[out] ppbVal
Указатель на расположение памяти, которое получает адрес буфера, выделенного этой функцией. По возвращении буфер содержит двоичные данные свойства.
[out, optional] ppbValOld
Указатель на расположение памяти, которое получает адрес буфера, выделенного мини-driver. При возвращении буфер содержит предыдущее значение двоичных данных свойства. Если эти сведения не нужны, этот параметр можно задать для null.
bMustExist
Указывает, должно ли существовать свойство. Если задано значение TRUE, свойство должно существовать; Если задано значение FALSE, свойство не обязательно существует.
Возвращаемое значение
При успешном выполнении функция возвращает S_OK.
Если функция завершается ошибкой, она возвращает стандартную ошибку COM или один из кодов ошибок WIA .
Замечания
Эта функция выделяет буфер и сохраняет его адрес в параметре ppbVal. Мини-driver должен освободить буфер, вызвав CoTaskMemFree.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | wiamdef.h (включая Wiamdef.h) |
| библиотеки | Wiaservc.lib |
| DLL | Wiaservc.dll |