SQLSetDriverConnectInfo, funkcja

Zgodność
Wprowadzona wersja: ODBC 3.81 Zgodność ze standardami: ODBC

Podsumowanie
SQLSetDriverConnectInfo służy do ustawienia parametry połączenia w tokenie informacji o połączeniu dla wywołania SQLDriverConnect aplikacji.

Syntax

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

Arguments

TokenHandle
[Input] Uchwyt żetonów.

InConnectionString
[Input] Pełny parametry połączenia (patrz składnia w sekcji "Comments" w SQLDriverConnect), częściowy parametry połączenia lub ciąg pusty.

StringLength1
[Input] Długość *InConnectionString, w znakach, jeśli ciąg jest Unicode, lub bajtach, jeśli ciąg jest ANSI lub DBCS.

Zwroty

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR lub SQL_INVALID_HANDLE.

Diagnostyka

Podobnie jak SQLDriverConnect dotyczący błędów walidacji danych, z tą różnicą, że Driver Manager używa HandleType SQL_HANDLE_DBC_INFO_TOKEN oraz HandlehDbcInfoToken.

Remarks

Za każdym razem, gdy sterownik zwraca SQL_ERROR lub SQL_INVALID_HANDLE, Driver Manager zwraca błąd do aplikacji (w SQLConnect lub SQLDriverConnect).

Za każdym razem, gdy sterownik zwraca SQL_SUCCESS_WITH_INFO, Driver Manager pobiera informacje diagnostyczne z hDbcInfoToken i zwraca SQL_SUCCESS_WITH_INFO do aplikacji w SQLConnect i SQLDriverConnect.

Aplikacje nie powinny wywoływać tej funkcji bezpośrednio. Sterownik ODBC wspierający pulowanie połączeń świadomych sterowników musi implementować tę funkcję.

Uwzględnij sqlspi.h do tworzenia sterowników ODBC.

Treści powiązane

  • Last updated on