SQLSetDriverConnectInfo Functie

Conformiteit
Versie geïntroduceerd: ODBC 3.81 Standaardnaleving: ODBC

Samenvatting
SQLSetDriverConnectInfo wordt gebruikt om de verbindingsreeks in het connection info token voor de SQLDriverConnect-aanroep van een applicatie in te stellen.

Syntax

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );

Arguments

TokenHandle
[Invoer] Token-handvat.

InConnectionString
[Invoer] Een volledige verbindingsreeks (zie de syntaxis in "Comments" in SQLDriverConnect), een gedeeltelijke verbindingsreeks, of een lege string.

StringLength1
[Invoer] Lengte van *InConnectionString, in tekens als de string Unicode is, of bytes als string ANSI of DBCS is.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR of SQL_INVALID_HANDLE.

Diagnostiek

Hetzelfde als SQLDriverConnect met betrekking tot elke invoervalidatiefout, behalve dat de Driver Manager een HandleType van SQL_HANDLE_DBC_INFO_TOKEN en een Handle van hDbcInfoToken gebruikt.

Remarks

Telkens wanneer een driver SQL_ERROR of SQL_INVALID_HANDLE teruggeeft, geeft de Driver Manager de foutmelding terug naar de applicatie (in SQLConnect of SQLDriverConnect).

Telkens wanneer een driver SQL_SUCCESS_WITH_INFO terugstuurt, haalt de Driver Manager de diagnostische informatie op van hDbcInfoToken en stuurt SQL_SUCCESS_WITH_INFO terug naar de applicatie in SQLConnect en SQLDriverConnect.

Applicaties mogen deze functie niet direct aanroepen. Een ODBC-driver die driver-bewuste verbindingspooling ondersteunt, moet deze functie implementeren.

Voeg sqlspi.h toe voor ODBC-driverontwikkeling.

Verwante onderwerpen

  • Last updated on