Help Center
/
Help Center›AfxNova›ODBC Classes

CODBCBase.GetCPMatchmethod

Returns a 32-bit SQLUINTEGER value that determines how a connection is chosen from a connection pool.

DatabasesmethodCODBC.incdocumented

Syntax

FUNCTION GetCPMatch () AS SQLUINTEGER

Return value

The current value of the attribute.

Description

Returns a 32-bit SQLUINTEGER value that determines how a connection is chosen from a connection pool.

Remarks

The Driver Manager determines which connection is reused from the pool and attempts to match the connection options in the call and the connection attributes set by the application to the keywords and connection attributes of the connections in the pool. The value of this attribute determines the level of precision of the matching criteria. The following values are used to set the value of this attribute:

SQL_CP_STRICT_MATCH

Only connections that exactly match the connection options in the call and the connection attributes set by the application are reused. This is the default.

SQL_CP_RELAXED_MATCH

Connections with matching connection string keywords can be used. Keywords must match, but not all connection attributes must match.

Reference

  • Include file CODBC.inc
  • Defined in AfxNova/COdbc.inc:198
  • Documented in Databases/ODBC Classes/CODBC Class.md
  • Topic: ODBC Classes