SQLSetConnectInfo-functie

Conformiteit
Versie geïntroduceerd: ODBC 3.81 Standaardnaleving: ODBC

Samenvatting
SQLSetConnectInfo wordt gebruikt om de gegevensbron, gebruikers-ID en wachtwoord in te voeren in het verbindingsinformatietoken voor de SQLConnect-aanroep van een applicatie.

Syntax

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );

Arguments

TokenHandle
[Invoer] Token-handvat.

Servernaam
[Invoer] Naam van de gegevensbron. De gegevens bevinden zich mogelijk op dezelfde computer als het programma of op een andere computer ergens in een netwerk. Voor informatie over hoe een applicatie een databron kiest, zie Kies van een gegevensbron of driver.

NameLength1
[Invoer] Lengte van *ServerName in tekens.

UserName
[Invoer] Gebruikersidentificatie.

NameLength2
[Invoer] Lengte van *Gebruikersnaam in tekens.

Authentication
[Invoer] Authenticatiestring (meestal het wachtwoord).

NameLength3
[Invoer] Lengte van *Authenticatie in tekens.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR of SQL_INVALID_HANDLE.

Diagnostiek

Hetzelfde als SQLConnect voor invoervalidatiefouten, 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