Share via

  • Artykuł

SQLDriverConnect

SQL Server Sterownik ODBC macierzystym klienta definiuje atrybuty połączenia, które zastępuje lub zwiększają ciąg połączenia słów kluczowych.Kilka słów kluczowych w ciąg połączenia mają domyślne wartości określone przez SQL Server sterownik ODBC macierzystym klienta.

Lista słów kluczowych w SQL Server sterownika ODBC macierzystym klienta, zobacz Słowa kluczowe ciąg połączenia przy użyciu programu SQL Server Native Client.

Więcej informacji o SQL Server połączenia atrybuty i zachowania domyślnego sterownika, zobacz Procedura SQLSetConnectAttr.

Omówienie połączeń ciąg słowa kluczowe, które są ważne dla SQL Server Native Client, zobacz Słowa kluczowe ciąg połączenia przy użyciu programu SQL Server Native Client.

When the SQLDriverConnectDriverCompletion parameter value is SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE, or SQL_DRIVER_COMPLETE_REQUIRED, the SQL Server Native Client ODBC driver retrieves keyword values from the displayed dialog box.Jeśli wartość słowa kluczowego jest przekazywana w połączeniu z ciąg i użytkownik nie zmienia wartość słowa kluczowego w oknie dialogowym SQL Server sterownik ODBC macierzystym klienta używa wartości z połączenia ciąg.Jeśli wartość nie jest zestaw połączenie ciąg i użytkownika powoduje przypisanie nie w oknie dialogowym używa sterownika domyślnego.

SQLDriverConnect należy podać prawidłowy WindowHandle przy DriverCompletion wartość wymaga (lub może wymagać) Wyświetl okno dialogowe sterownika połączenia.Nieprawidłowe dojście zwraca wartość SQL_ERROR.

Określić sterownik lub DSN słowa kluczowe.ODBC stwierdza, że sterownik używa pierwszej z tych dwóch słów kluczowych i ignoruje drugiej, jeśli są określone oba.If DRIVER is specified, or is the leftmost of the two, and the SQLDriverConnectDriverCompletion parameter value is SQL_DRIVER_NOPROMPT, the SERVER keyword and an appropriate value are required.

Po określeniu SQL_DRIVER_NOPROMPT słowa kluczowe uwierzytelnianie użytkownika musi być obecny wartościami.Sterownik zapewnia, że albo ciąg "Trusted_Connection = yes" lub identyfikatorów UID i PWD słowa kluczowe są obecne.

Jeśli DriverCompletion wartość parametru jest SQL_DRIVER_NOPROMPT lub SQL_DRIVER_COMPLETE_REQUIRED oraz język albo bazy danych pochodzi z połączenia ciąg i albo jest nieprawidłowy, SQLDriverConnect zwraca wartość SQL_ERROR.

Jeśli DriverCompletion wartość parametru jest SQL_DRIVER_NOPROMPT lub SQL_DRIVER_COMPLETE_REQUIRED oraz język albo bazy danych pochodzi z definicji źródło danych ODBC i albo jest nieprawidłowy, SQLDriverConnect używa identyfikatora określonego użytkownika język domyślny lub bazy danych i zwraca wartość SQL_SUCCESS_WITH_INFO.

Jeśli DriverCompletion wartość parametru jest SQL_DRIVER_COMPLETE lub SQL_DRIVER_PROMPT i jeśli język lub bazy danych jest nieprawidłowa, SQLDriverConnect ponownie wyświetli okno dialogowe.

Obsługa SQLDriverConnect główne nazwy usług (SPN)

SQLDDriverConnect użyje logowania ODBC monitowania boxwhen okno dialogowe jest włączona.Dzięki temu SPN wprowadzone dla serwer dublowany i jego partner pracy awaryjnej.

SQLDriverConnectbędzie akceptować nowe połączenia ciąg słowa kluczowe ServerSPN i FailoverPartnerSPNi rozpozna nowe atrybuty połączeń SQL_COPT_SS_SERVER_SPN i SQL_COPT_SS_FAILOVER_PARTNER_SPN

Gdy wartość atrybut połączenia określono więcej niż raz, wartość jest ustawiana programowo pierwszeństwo wartości w DSN i w związku z ciąg.Wartość w DSN mają pierwszeństwo przed wartością w połączeniu ciąg.

Po otwarciu połączenia SQL Server Ustawia Native Client, SQL_COPT_SS_MUTUALLY_AUTHENTICATED i SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD metoda uwierzytelnianie używany do otwierania połączenia.

Aby uzyskać więcej informacji dotyczących nazwy SPN, zobacz Główne nazwy usług (SPN) w połączeń klienta (ODBC).

Przykłady

Następujące wywołanie ilustruje najmniejszą ilość danych wymaganych dla SQLDriverConnect:

SQLDriverConnect(hdbc, hwnd,
    (SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);

Minimalne wymagane dane przedstawiają następujące ciągi połączeń podczas DriverCompletion wartość parametru jest 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"