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

Функция 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, ранее выделенных мини-driver. При возвращении массив содержит предыдущие значения данных свойства. Если эти сведения не нужны, этот параметр можно задать для null.

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

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

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

Замечания

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

Требования

См. также

wiasWriteMultiple