SQLSetConnectInfo-funktion

Överensstämmelse
Version introducerad: ODBC 3.81 Standardefterlevnad: ODBC

Summary
SQLSetConnectInfo används för att ställa in datakälla, användar-ID och lösenord i anslutningsinfotoken för en applikations SQLConnect-anrop .

Syntax

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

Arguments

TokenHandle
[Input] Token-handtag.

ServerName
[Input] Namnkällan. Data kan finnas på samma dator som programmet eller på en annan dator någonstans i ett nätverk. För information om hur en applikation väljer en datakälla, se Val av datakälla eller drivrutin.

NameLength1
[Input] Längden på *ServerName i tecken.

UserName
[Input] Användaridentifierare.

NameLength2
[Input] Längden på *Användarnamn i tecken.

autentisering
[Input] Autentiseringssträng (vanligtvis lösenordet).

NameLength3
[Input] Längd på *Autentisering i tecken.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR eller SQL_INVALID_HANDLE.

Diagnostics

Samma som SQLConnect för inmatningsvalideringsfel, förutom att Driver Manager använder en HandleType av SQL_HANDLE_DBC_INFO_TOKEN och ett Handle av hDbcInfoToken.

Remarks

När en drivrutin returnerar SQL_ERROR eller SQL_INVALID_HANDLE returnerar Driver Manager felet till applikationen (i SQLConnect eller SQLDriverConnect).

När en drivrutin returnerar SQL_SUCCESS_WITH_INFO hämtar Driver Manager diagnosinformationen från hDbcInfoToken och returnerar SQL_SUCCESS_WITH_INFO till applikationen i SQLConnect och SQLDriverConnect.

Applikationer bör inte anropa denna funktion direkt. En ODBC-drivrutin som stödjer drivrutinsmedveten anslutningspooling måste implementera denna funktion.

Inkludera sqlspi.h för ODBC-drivrutinsutveckling.

Relaterat innehåll

  • Uppdaterades senast