|
Start an asynchronous Method invocation.
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
-
obj | The object on which to make the invocation. This should not be NULL. |
method | The Method to invoke. This should not be NULL. |
parameterCount | The count of DOFValue elements in parameters. |
parameters | The list of input parameters to the Method. This may be NULL if there are no parameters for the Method. Otherwise, the values should match the input parameters defined by the Method. |
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 | The callback through which responses and the completion notification will be received. This may be null to ignore notification of the received values. The values (result) can be retrieved by calling DOFOperationInvoke_WaitResult. |
context | Application context data associated with the asynchronous operation. |
- Returns
- A representation of the operation, or NULL if
- an invalid parameter is detected (including incompatible paramaters or parameterCount passed for the method); or
- insufficient resources exist to create the operation.
|