Register a requestor callback for notifying us when the submitted provider event is signaled, and ask the provider of that event and the submitted DOFObject to signal the event.
For the duration of the DOFOperation, the callback will be called each time an Event is signaled, along with associated data sent by the provider. As with any DOFOperation, this operation can be extended or cancelled.
- Resource Management:
- This function allocates resources that must later be freed by calling DOFOperation_Destroy.
- Parameters
-
obj | The object on which to watch for the Event. This should not be NULL. |
evt | The Event to watch. This should not be NULL. |
config | Configuration options for the request operation (NULL for default configuration). |
timeout | The duration for the asynchronous operation, in milliseconds (specifies the duration of the registration). The timeout begins after the operation has been processed and sent to appropriate connections. |
callback | The callback through which responses and the completion notification will be received. This may be null to ignore notification of the received events. Events are only reported to the callback. |
context | Application context data associated with the asynchronous operation. |
- Returns
- A representation of the operation, or NULL if
- an invalid parameter is detected; or
- insufficient resources exist to create the operation.