OpenDOF Project
DOFOperation DOFSystem_BeginInterest ( const DOFSystem  sys,
const DOFObjectID  objectID,
const DOFInterfaceID  interfaceID,
DOFInterestLevel  level,
DOFOperationControl  config,
uint32  timeout,
const DOFSystemInterestCallback  callback,
void *  context 
)

Express interest for an Object ID and an Interface IDs.

This is a request only; the callback is called only when the request is complete (timed out or cancelled) and does not indicate a response.

Resource Management:
This function allocates resources that must later be freed by calling DOFOperation_Destroy.
Parameters
sysThe system in which the Interest request is to be made. This must not be NULL.
objectIDThe object ID on which to express interest. If level is DOFINTERESTLEVEL_WATCH, then this may be DOFOBJECTID_BROADCAST to express interest on all object IDs (other levels do not support broadcast). This should not be NULL.
interfaceIDThe interface ID on which to express interest. If level is DOFINTERESTLEVEL_WATCH or DOFINTERESTLEVEL_ACTIVATE, then this may be DOFINTERFACEID_WILDCARD to express interest on all interface IDs (other levels do not support wildcard). This should not be NULL.
levelThe level of interest to request. This should be a level from DOFInterestLevel.
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.
callbackCallback when operation completes. This may be NULL to ignore completion notification.
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.5 Build 0
2017-01-25