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

Статья
08/08/2023

Функция wiasReadMultiple извлекает несколько значений свойств из элемента WIA.

Синтаксис

HRESULT wiasReadMultiple(
  [in]            BYTE           *pWiasContext,
                  ULONG          ulCount,
  [in]            const PROPSPEC *ps,
  [out]           PROPVARIANT    *pv,
  [out, optional] PROPVARIANT    *pvOld
);

Параметры

[in] pWiasContext

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

ulCount

Указывает количество считываемых свойств.

[in] ps

Указатель на первый элемент массива структур PROPSPEC , содержащий считываемые свойства.

[out] pv

Указатель на первый элемент массива структур PROPVARIANT . После возврата эти структуры содержат новые значения для свойств .

[out, optional] pvOld

Указатель на первый элемент массива структур PROPVARIANT, ранее выделенных мини-накопителем. При возврате массив содержит предыдущие значения данных свойства. Если эти сведения не требуются, для этого параметра можно задать значение NULL.

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

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

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

Эта функция считывает несколько свойств из элемента WIA. После успешного вызова мини-диск должен вызвать PropVariantClear для каждого элемента в массиве, заданном параметром pv . Дополнительные сведения см. в разделе IPropertyStorage::ReadMultiple .

Требования

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

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

wiasWriteMultiple

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