SQLDriverConnect
van toepassing op:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Het ODBC-stuurprogramma van sql Server Native Client definieert verbindingskenmerken die trefwoorden voor verbindingsreeksen vervangen of verbeteren. Verschillende trefwoorden voor verbindingsreeksen hebben standaardwaarden opgegeven door het ODBC-stuurprogramma van sql Server Native Client.
Zie Trefwoorden voor verbindingsreeksen gebruiken met SQL Server Native Clientvoor een lijst met trefwoorden die beschikbaar zijn in het ODBC-stuurprogramma van sql Server Native Client.
Zie SQLSetConnectAttrvoor meer informatie over standaardgedrag van SQL Server-verbindingskenmerken en stuurprogramma's.
Zie Trefwoorden voor verbindingsreeksen gebruiken met SQL Server Native Clientvoor een discussie over trefwoorden voor verbindingsreeksen die geldig zijn voor SQL Server Native Client.
Wanneer de parameterwaarde SQLDriverConnectDriverCompletion is SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE of SQL_DRIVER_COMPLETE_REQUIRED, worden trefwoordwaarden opgehaald uit het weergegeven dialoogvenster. Als de trefwoordwaarde wordt doorgegeven in de verbindingsreeks en de gebruiker de waarde voor het trefwoord in het dialoogvenster niet wijzigt, gebruikt het ODBC-stuurprogramma van de SQL Server Native Client de waarde uit de verbindingsreeks. Als de waarde niet is ingesteld in de verbindingsreeks en de gebruiker geen toewijzing maakt in het dialoogvenster, gebruikt het stuurprogramma de standaardwaarde.
SQLDriverConnect- moet een geldige WindowHandle- krijgen wanneer voor een DriverCompletion-waarde de weergave van het verbindingsdialoogvenster van het stuurprogramma is vereist (of vereist). Een ongeldige ingang retourneert SQL_ERROR.
Geef de trefwoorden DRIVER of DSN op. ODBC geeft aan dat een stuurprogramma de meest linkse van deze twee trefwoorden gebruikt en negeert de andere als beide zijn opgegeven. Als DRIVER is opgegeven of het meest links van de twee is en de SQLDriverConnectDriverCompletion parameterwaarde is SQL_DRIVER_NOPROMPT, zijn het trefwoord SERVER en een juiste waarde vereist.
Wanneer SQL_DRIVER_NOPROMPT is opgegeven, moeten trefwoorden voor gebruikersverificatie aanwezig zijn met waarden. Het stuurprogramma zorgt ervoor dat de tekenreeks 'Trusted_Connection=ja' of zowel de UID als PWD-trefwoorden aanwezig zijn.
Als de parameterwaarde
Als de parameterwaarde DriverCompletion is SQL_DRIVER_NOPROMPT of SQL_DRIVER_COMPLETE_REQUIRED en de taal of database afkomstig is van de ODBC-gegevensbrondefinities en deze ongeldig is, gebruikt SQLDriverConnect de standaardtaal of database voor de opgegeven gebruikers-id en retourneert SQL_SUCCESS_WITH_INFO.
Als de parameterwaarde DriverCompletion is SQL_DRIVER_COMPLETE of SQL_DRIVER_PROMPT en als de taal of database ongeldig is, SQLDriverConnect het dialoogvenster opnieuw weergeven.
SQLDriverConnect-ondersteuning voor hoge beschikbaarheid, herstel na noodgevallen
Zie systeemeigen SQL Server-clientondersteuning voor hoge beschikbaarheid, herstel na noodgevallenvoor meer informatie over het gebruik van SQLDriverConnect om verbinding te maken met een AlwaysOn-beschikbaarheidsgroepcluster.
SQLDriverConnect-ondersteuning voor Service Principal Names (SPN's)
SQLDDriverConnect gebruikt het dialoogvenster ODBC-aanmelding wanneer u hierom wordt gevraagd. Hierdoor kunnen SPN's worden ingevoerd voor zowel de principal-server als de failoverpartner.
SQLDriverConnect accepteert de nieuwe trefwoorden voor verbindingsreeksen ServerSPN- en FailoverPartnerSPN-, en herkent de nieuwe verbindingskenmerken SQL_COPT_SS_SERVER_SPN en SQL_COPT_SS_FAILOVER_PARTNER_SPN.
Wanneer een waarde van een verbindingskenmerk meerdere keren wordt opgegeven, heeft een waarde die programmatisch is ingesteld voorrang op de waarde in een DSN en een waarde in een verbindingsreeks. Een waarde in een DSN heeft voorrang op een waarde in een verbindingsreeks.
Wanneer een verbinding wordt geopend, stelt SQL Server Native Client SQL_COPT_SS_MUTUALLY_AUTHENTICATED en SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD in op de verificatiemethode die wordt gebruikt om de verbinding te openen.
Zie SPN's (Service Principal Names) in ODBC-(Client Connections) voor meer informatie over SPN's.
Voorbeelden
De volgende aanroep illustreert de minste hoeveelheid gegevens die nodig is voor SQLDriverConnect-:
SQLDriverConnect(hdbc, hwnd,
(SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
De volgende verbindingsreeksen illustreren minimaal vereiste gegevens wanneer de parameterwaarde DriverCompletion is SQL_DRIVER_NOPROMPT:
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"
Zie ook
SQLDriverConnect-functie
odbc-API-implementatiedetails
ANSI_NULLS (Transact-SQL) instellen
ANSI_PADDING (Transact-SQL)
ANSI_WARNINGS (Transact-SQL)