|
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
-
sys | The system in which the Interest request is to be made. This must not be NULL. |
objectID | The 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. |
interfaceID | The 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. |
level | The level of interest to request. This should be a level from DOFInterestLevel. |
config | Configuration options for the request operation (NULL for default configuration). |
timeout | The duration for the asynchronous operation, in milliseconds. The timeout begins after the operation has been processed and sent to appropriate connections. |
callback | Callback when operation completes. This may be NULL to ignore completion notification. |
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.
|