OASQLIP_connect
- Last Updated: May 12, 2026
- 1 minute read
- OpenAccess SDK
- Version 8.1
- Documentation
This function connects to the specified database using the specified user name and password. In multi-threaded mode, each connection is on a new thread created by the server. Using the process/connect (forking) mode, this function is called from a forked image of the server process.
int OASQLIP_connect(
SQLIP_HDBC sqlip_hdbc,
OAWCHAR * psDataSourceName,
OAWCHAR * psUid,
OAWCHAR * psPwd,
OAWCHAR * psDataSourceCurrentCatalog,
OAWCHAR * psDataSourceIPClass,
OAWCHAR * psDataSourceIPProperties,
OAWCHAR * psDataSourceIPCustomProperties)
Parameters for OASQLIP_connect
| Parameter | Type | Description |
| INPUT | ||
| sqlip_hdbc | SQLIP_HDBC | Connection handle on which to establish a connection. |
| psDataSourceName | OAWCHAR * | The data source to which the connection is being made. |
| psUid | OAWCHAR * | User ID |
| psPwd | OAWCHAR * | Password. |
| psDataSourceCurrentCatalog | OAWCHAR * | Current catalog, if specified by the client. |
| psDataSourceIPClass | OAWCHAR * | Value of the DataSourceIPClass attribute. The IP can use this attribute for its own purpose. |
| psDataSourceIPProperties | OAWCHAR * | Value of the DataSourceIPProperties configured for this data source. The IP can use this attribute for its own purpose. |
| psDataSourceIPCustomProperties | OAWCHAR * | Custom connect string portion as passed in by the client. This can be parsed to retrieve any custom connection level options. |
| RETURN | ||
| int | OADS_SUCCESS – connected. OADS_ERROR – error occurred during connection. |