Cause the Connection to start connecting, if possible.
If the Connection is already connected, then this call is satisfied immediately. It is the responsibility of the caller to eventually call DOFConnection_Disconnect when the connection is no longer desired.
The callback is called to indicate that the connection either connected successfully or failed. Any state listeners added to the connection will be notified if this causes the state to change, but are otherwise unrelated to the callback specified here.
- Note
- This call is asynchronous, and does not wait for the Connection to be established before returning control to the caller.
-
This connection request cannot be cancelled. It is resolved by eventual success, explicit failure, or timeout.
-
If the callback is notified of a successful connection, DOFConnection_Disconnect can be called to terminate the connection.
- Parameters
-
| self | The Connection. This must not be NULL. |
| timeout | The maximum time to wait for the Connection to be established. |
| callback | The Connection completion callback to be called when asynchronous operation finishes. If NULL, no callback will be called, regardless of whether the connection succeeds or fails. |
| context | The context, if any, associated with this connection request. |
- See Also
- DOFConnection_AddStateListener
