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

Метод IScanProfile::SetProperty

  • Статья

Задает значение указанных дочерних свойств в элементе <Properties> профиля сканирования.

Синтаксис

HRESULT SetProperty(
  [in] ULONG       num,
  [in] PROPID      *pid,
  [in] PROPVARIANT *pvar
);

Параметры

num [in]

Тип: ULONG

Количество записей в массивах, на которые указывают pid и pvar.

pid [in]

Тип: PROPID*

Указатель на массив идентификационных номеров устанавливаемых свойств. Каждое значение в массиве является константами свойств WIA.

pvar [in]

Тип: PROPVARIANT*

Указатель на массив значений, присваиваемых свойствам.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Каждое значение в массиве, на который указывает pid , является одной из констант свойств WIA. Эту систему идентификации можно расширить. См. раздел Определение настраиваемых свойств.

Изменения профиля не сохраняются на диске, пока приложение не вызовет метод IScanProfile::Save .

Если два приложения создают объекты профиля сканирования из одного XML-файла и каждое приложение записывает изменения в свой объект, на диск сохраняются только изменения, внесенные приложением, которое вызывает IScanProfile::Save last.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]
Заголовок
Scanprofile.h
IDL
Scanprofiles.idl

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

IScanProfile

Основные понятия

Схема профиля сканирования

Константы свойств WIA

Определение настраиваемых свойств