Функция 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
Указатель на расположение памяти, которое получает адрес буфера, выделенного мини-накопителем. После возврата буфер содержит предыдущее значение двоичных данных свойства. Если эти сведения не требуются, для этого параметра можно задать значение NULL.
bMustExist
Указывает, должно ли существовать свойство. Если задано значение TRUE, свойство должно существовать; Если задано значение FALSE, свойство не обязательно существовать.
Возвращаемое значение
При успешном выполнении функция возвращает S_OK.
Если функция завершается сбоем, она возвращает стандартную ошибку COM или один из кодов ошибок WIA.
Комментарии
Эта функция выделяет буфер и сохраняет его адрес в параметре ppbVal . Мини-диск должен освободить буфер, вызвав CoTaskMemFree.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wiamdef.h (включая Wiamdef.h) |
| Библиотека | Wiaservc.lib |
| DLL | Wiaservc.dll |