IPropertyNotifySink::OnRequestEdit method (ocidl.h)
Notifies a sink that a requestedit property is about to change.
HRESULT OnRequestEdit( [in] DISPID dispID );
The dispatch identifier of the property that is about to change or DISPID_UNKNOWN if multiple properties are about to change.
This method can return the following values.
||The specified property or properties are allowed to change.|
||The specified property or properties are not allowed to change. The caller must obey this return value by discarding the new property value(s). This is part of the contract of the [requestedit] attribute and this method.|
The sink may choose to allow or disallow the change to take place. For example, the sink may enforce a read-only state on the property. DISPID_UNKNOWN is a valid parameter to this method to indicate that multiple properties are about to change. In this case, the sink can enforce a global read-only state for all [requestedit] properties in the object, including any specific ones that the sink otherwise recognizes.
This method cannot be used to implement any sort of data validation. At the time of the call, the desired new value of the property is unavailable and thus cannot be validated. This method's only purpose is to allow the sink to enforce a read-only state on a property.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|