Cause the Connection to become Connected, 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.
- Note
- This call is synchronous, and waits for the Connection to be established (or fail) before returning control to the caller.
- Parameters
-
| self | The Connection. This must not be NULL. |
| timeout | The maximum time to wait for the connection to be established (in milliseconds). |
[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. |
- Return values
-
TRUE | If the connection connected. |
- Exceptions
-
FALSE | If the connection failed to connect. If an exception was used it will give more detail of failure. |