Funkce SQLSetConnectInfo

Soulad
Představená verze: ODBC 3.81 Shoda standardů: ODBC

Summary
SQLSetConnectInfo se používá k nastavení zdroje dat, uživatelského ID a hesla do tokenu o spojení pro volání SQLConnect aplikace.

Syntax

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

Arguments

TokenHandle
[Vstup] Token handle.

název serveru
[Vstup] Název zdroje dat. Data můžou být umístěná ve stejném počítači jako program nebo v jiném počítači někde v síti. Pro informace o tom, jak aplikace vybírá zdroj dat, viz Volba zdroje dat nebo ovladače.

NameLength1
[Vstup] Délka *ServerName ve znacích.

UserName
[Vstup] Identifikátor uživatele.

NameLength2
[Vstup] Délka *UserName " v znacích.

Authentication
[Vstup] Autentizační řetězec (obvykle heslo).

NameLength3
[Vstup] Délka *Autentizace znaky.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR nebo SQL_INVALID_HANDLE.

Diagnostika

Stejně jako SQLConnect pro chyby při ověřování vstupů, s tím rozdílem, že Driver Manager používá HandleType SQL_HANDLE_DBC_INFO_TOKEN a HandlehDbcInfoToken.

Remarks

Kdykoli ovladač vrátí SQL_ERROR nebo SQL_INVALID_HANDLE, správce ovladačů vrátí chybu aplikaci (v SQLConnect nebo SQLDriverConnect).

Kdykoli ovladač SQL_SUCCESS_WITH_INFO vrátí, správce ovladačů získá diagnostické informace z hDbcInfoToken a vrátí SQL_SUCCESS_WITH_INFO aplikaci v SQLConnect a SQLDriverConnect.

Aplikace by tuto funkci neměly volat přímo. ODBC ovladač, který podporuje poolování připojení s vědomím ovladačů, musí tuto funkci implementovat.

Zahrňte sqlspi.h pro vývoj ovladačů ODBC.

Související obsah

  • Last updated on