SQLSetConnectInfo 函式

符合性
推出版本:ODBC 3.81 標準合規:ODBC

總結
SQLSetConnectInfo 用於將資料來源、使用者 ID 和密碼設定為應用程式 SQLConnect 呼叫的連線資訊權杖。

Syntax

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

論點

TokenHandle
[輸入]令牌名稱。

ServerName
[輸入]資料來源名稱。 資料可能和程式位於相同的電腦上,也可能位於網路內的其他電腦上。 關於應用程式如何選擇資料來源的資訊,請參見 「選擇資料來源或驅動程式」。

名稱長度1
[輸入]*ServerName 字元長度。

UserName
[輸入]使用者識別碼。

名稱長度2
[輸入]*使用者名稱 字元長度。

驗證
[輸入]驗證字串(通常是密碼)。

名稱長度3
[輸入]*以字元為單位的認證 長度。

Returns

SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR或SQL_INVALID_HANDLE。

Diagnostics

輸入驗證錯誤與 SQLConnect 相同,但驅動程式管理器會使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleTypehDbcInfoTokenHandle

備註

每當驅動返回 SQL_ERROR 或 SQL_INVALID_HANDLE,驅動管理員會將錯誤傳回應用程式(以 SQLConnectSQLDriverConnect 進行)。

每當驅動程式返回SQL_SUCCESS_WITH_INFO時,驅動程式管理器會從 hDbcInfoToken 取得診斷資訊,並以 SQLConnectSQLDriverConnect 將SQL_SUCCESS_WITH_INFO回傳給應用程式。

應用程式不應直接呼叫此函式。 支援驅動程式感知連線池的 ODBC 驅動程式必須實作此功能。

請包含 sqlspi.h 以開發 ODBC 驅動程式。