IPropertyNotifySink::OnRequestEdit 方法 (ocidl.h)
通知接收器 requestedit 属性即将更改。
语法
HRESULT OnRequestEdit(
[in] DISPID dispID
);
参数
[in] dispID
即将更改的属性的调度标识符,如果多个属性即将更改,则DISPID_UNKNOWN。
返回值
此方法可以返回以下值。
返回代码 | 说明 |
---|---|
|
允许更改指定的一个或多个属性。 |
|
不允许更改指定的一个或多个属性。 调用方必须通过放弃新属性值 () 来遵守此返回值。 这是 [requestedit] 属性和此方法协定的一部分。 |
注解
接收器可以选择允许或禁止进行更改。 例如,接收器可能会对 属性强制实施只读状态。 DISPID_UNKNOWN是此方法的有效参数,用于指示多个属性即将更改。 在这种情况下,接收器可以为对象中的所有 [requestedit] 属性强制实施全局只读状态,包括接收器在其他方面识别的任何特定属性。
如果接收器允许更改,则对象还必须为除 [requestedit] 之外标记为 [bindable] 的任何属性发出 IPropertyNotifySink::OnChanged 通知。
此方法不能用于实现任何类型的数据验证。 调用时,属性的所需新值不可用,因此无法验证。 此方法的唯一用途是允许接收器对属性强制实施只读状态。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ocidl.h |