OpenDOF Project
DOFOperation DOFObject_BeginRegister ( DOFObject  obj,
const DOFInterfaceEvent  evt,
DOFOperationControl  config,
uint32  timeout,
const DOFObjectEventCallback  callback,
void *  context 
)

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
objThe object on which to watch for the Event. This should not be NULL.
evtThe Event to watch. This should not be NULL.
configConfiguration options for the request operation (NULL for default configuration).
timeoutThe 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.
callbackThe 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.
contextApplication 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.
core-c-dof-oal Version 7.1.7 Build 0
2017-10-31