|
|
Callback for a Provider when a DOFInterfaceProperty is to be set.
This callback may be NULL if the application does not implement the capability to set a Property (if the interface supports writable properties, any attempt to set them will cause a generic exception response).
- Parameters
-
| self | The callback object. This will never be NULL. |
| operation | The Provide Operation. This will never be NULL. |
| property | The Property being Set. This will never be NULL. |
| value | The new Value for the Property. This will never be NULL. |
| request | A representation of the requestor. This will never be NULL. |
- Note
- The request must be completed by either indicating successful completion via DOFRequestSet_Return, or returning an exception via DOFRequest_Throw. All parameters to this callback remain valid and may be referenced by the application until either the end of the callback or the request is completed as described, whichever is LATER. It is the responsibility of the application to ensure the request is eventually completed.
-
Successful completion of the Set request will cause the library to assume the property changed, and will automatically notify any subscribers. There is no need for the application to call DOFObject_Changed as a result of the Set request (doing so may cause excess subscription notifications to be generated).
|
