[This is preliminary documentation and subject to change.]
This function allocates memory for a connection handle within the environment specified by the environment handle passed in. This returns SQL_ERROR if memory cannot be allocated for the handle. It returns a handle of SQL_NULL_HDBC. The client can then ask for more error information by using SqlError, this handle, and a statement of SQL_NULL_HSTMT. Otherwise, it returns SQL_SUCCESS.