SQLSetConnectInfo, funkcja

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

Podsumowanie
SQLSetConnectInfo służy do ustawienia źródła danych, identyfikatora użytkownika i hasła do tokena informacji o połączeniu dla połączenia wywołania SQLConnect aplikacji.

Syntax

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

Arguments

TokenHandle
[Input] Uchwyt żetonów.

Nazwa serwera
[Input] Nazwa źródła danych. Dane mogą znajdować się na tym samym komputerze co program lub na innym komputerze w sieci. Aby uzyskać informacje o tym, jak aplikacja wybiera źródło danych, zobacz Wybór źródła danych lub sterownika.

NameLength1
[Input] Długość *ServerName w znakach.

UserName
[Input] Identyfikator użytkownika.

NameLength2
[Input] Długość *UserName w znakach.

Authentication
[Input] Ciąg uwierzytelniający (zazwyczaj hasło).

NameLength3
[Input] Długość *Uwierzytelnianie w znakach.

Zwroty

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR lub SQL_INVALID_HANDLE.

Diagnostyka

Podobnie jak SQLConnect dla 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