|
|
Invoke a Method.
The specified timeout is a maximum duration for the operation, and the operation fails if the timeout is reached before a response is received. Otherwise, the first response received is returned. Broadcast operations will be cancelled immediately after the first response, and therefore may not reach or be processed by all available providers.
- Note
- Beware that a timeout of DOF_TIMEOUT_NEVER may NEVER return if a response is not received!
- 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 time we wait for results, in milliseconds. The timeout begins after the operation has been processed and sent to appropriate connections. |
| [out] | pException | An Exception. If pException is NULL, no exception is reported. Otherwise, the output is either a DOFException, or NULL to indicate no exception occurred. DOFException_Destroy must be called to destroy the returned DOFException, if any. |
- Returns
- The result of the Invoke operation, indicating success and containing the returned method values.
- Exceptions
-
| NULL | is returned and pException is filled (if not null) with an appropriate exception in the following conditions:
- The provider returned an exception
- An invalid parameter was detected (including incompatible parameters or parameterCount passed for the method)
- Insufficient resources available to perform the operation
|
|
