skip to main content
Interface Provider API : Reference : OAIP_setInfo
 

OAIP_setInfo

This function modifies the IP settings. OAIP_setInfo is used by the OpenAccess SDK SQL engine to pass configuration changes to the IP.
See Table 30 for the types of information that the IP can provide.
int OAIP_setInfo(
    IP_HENV henv,
    IP_HDBC ip_hdbc,
    IP_HSTMT hstmt,
    int iInfoType,
    void    * pInfoValue,
    int        iInfoValueLen)
Table 29. Parameters for OAIP_setInfo
Parameter
Type
Description
IN
henv
IP_HENV
The data structure allocated by the IP to keep its information.
ip_hdbc
IP_HDBC
If a connection level or a statement level setting, then this value is a pointer to the connection data you allocated. Otherwise, it is NULL.
hstmt
IP_HSTMT
If a statement level setting, then this is a pointer to the statement data you allocated. Otherwise, it is NULL.
iInfoType
int
The type of information. See Table 30 for the types of information that the IP can provide.
pInfoValue
void *
A pointer to the buffer containing the information value. Some iInfoTypes pass strings and others pass integers.
iInfoValueLen
int
The size of the buffer in bytes.
RETURN
int
DAM_SUCCESS - on success
DAM_NOT_AVAILABLE - value not supported by the IP
Table 30. Information Type for OAIP_setInfo
Information Type
Description
IP_INFO_QUALIFIER_NAME, IP_INFO_QUALIFIER_NAMEW
The value of the current qualifier for the connection. The IP should return schema information based on the current qualifier. The value is specified as String. Information is passed in as a Unicode string with IP_INFO_QUALIFIER_NAMEW if OAIP_getSupport(IP_SUPPORT_UNICODE_INFO) returned 1.
IP_INFO_TXN_ISOLATION
Transaction isolation level that is being requested by the client. The IP can use this information to control how it locks the data it accesses. The value is an integer.
*SQL_TXN_READ_UNCOMMITTED
*SQL_TXN_READ_COMMITTED
*SQL_TXN_REPEATABLE_READ
*SQL_TXN_SERIALIZABLE