Метод IScanProfile::RemoveProperty

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

Синтаксис

HRESULT RemoveProperty(
  [in] ULONG  num,
  [in] PROPID *pid
);

Параметры

num [in]

Тип: ULONG

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

pid [in]

Тип: PROPID*

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

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

Тип: HRESULT

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

Комментарии

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

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

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

Требования

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

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

IScanProfile

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

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

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

Определение пользовательских свойств