OpenDOF Project
DOFOperation DOFObject_BeginGet ( DOFObject  obj,
const DOFInterfaceProperty  property,
DOFOperationControl  config,
uint32  timeout,
const DOFObjectGetCallback  callback,
void *  context 
)

Start an asynchronous get of a Property's value.

The specified timeout is a maximum duration for the operation, and the operation fails if the timeout is reached before a response is received. The operation may complete sooner if a response is received, but multicast operations always wait for the full timeout. Responses and notification of operation completion are received through the specified callback. 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 from which to get the Property's value. This should not be NULL.
propertyThe Property to get. This should not be NULL.
configConfiguration options for the request operation (NULL for default configuration).
timeoutThe duration for the asynchronous operation, in milliseconds. 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 value. The value (result) can be retrieved by calling DOFOperationGet_WaitResult.
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 8.0.1 Build 0
2018-01-22