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

Метод IPropertyNotifySink::OnRequestEdit (ocidl.h)

  • Статья

Уведомляет приемник о том, что свойство requestedit вот-вот изменится.

Синтаксис

HRESULT OnRequestEdit(
  [in] DISPID dispID
);

Параметры

[in] dispID

Идентификатор диспетчеризации свойства, которое изменится или DISPID_UNKNOWN, если несколько свойств собираются изменить.

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

Этот метод может возвращать следующие значения.

Код возврата Описание
S_OK
 Указанное свойство или свойства могут изменяться.
S_FALSE
 Указанное свойство или свойства не могут изменяться. Вызывающий объект должен подчиняться этому возвращаемого значению путем отмены новых значений свойств. Это часть контракта атрибута [requestedit] и этого метода.

Комментарии

Приемник может разрешить или запретить изменение. Например, приемник может применять состояние только для чтения для свойства . DISPID_UNKNOWN является допустимым параметром этого метода, чтобы указать, что несколько свойств собираются изменить. В этом случае приемник может применить глобальное состояние только для чтения для всех свойств объекта [requestedit], включая любые определенные свойства, распознанные приемником в противном случае.

Если приемник допускает изменения, объект должен также отправлять уведомления IPropertyNotifySink::OnChanged для всех свойств, помеченных как [привязываемые] в дополнение к [requestedit].

Этот метод нельзя использовать для реализации какой-либо проверки данных. Во время вызова нужное новое значение свойства недоступно и поэтому не может быть проверено. Единственная цель этого метода заключается в том, чтобы разрешить приемнику применять состояние только для чтения для свойства .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

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

IPropertyNotifySink