IPropertyNotifySink::OnRequestEdit 方法 (ocidl.h)

通知接收器 requestedit 属性即将更改。

语法

HRESULT OnRequestEdit(
  [in] DISPID dispID
);

参数

[in] dispID

即将更改的属性的调度标识符,如果多个属性即将更改,则DISPID_UNKNOWN。

返回值

此方法可以返回以下值。

返回代码 说明
S_OK
允许更改指定的一个或多个属性。
S_FALSE
不允许更改指定的一个或多个属性。 调用方必须通过放弃新属性值 () 来遵守此返回值。 这是 [requestedit] 属性和此方法协定的一部分。

注解

接收器可以选择允许或禁止进行更改。 例如,接收器可能会对 属性强制实施只读状态。 DISPID_UNKNOWN是此方法的有效参数,用于指示多个属性即将更改。 在这种情况下,接收器可以为对象中的所有 [requestedit] 属性强制实施全局只读状态,包括接收器在其他方面识别的任何特定属性。

如果接收器允许更改,则对象还必须为除 [requestedit] 之外标记为 [bindable] 的任何属性发出 IPropertyNotifySink::OnChanged 通知。

此方法不能用于实现任何类型的数据验证。 调用时,属性的所需新值不可用,因此无法验证。 此方法的唯一用途是允许接收器对属性强制实施只读状态。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

另请参阅

IPropertyNotifySink