skip to main content
IP API Reference for C/C++ : IP API for C/C++ : OASQLIP_connect
 

OASQLIP_connect

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)
 
Table 13: 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.