「SQLSetDriverConnectInfo」函式

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

總結
SQLSetDriverConnectInfo 用於將 連接字串 設定為應用程式 SQLDriverConnect 呼叫的 connection info 權杖。

Syntax

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

論點

TokenHandle
[輸入]令牌名稱。

InConnectionString
[輸入]完整的 連接字串(詳見 SQLDriverConnect 中「Comments」中的語法)、部分 連接字串,或空字串。

StringLength1
[輸入]*InConnectionString 的長度,若字串是 Unicode,則以字元為單位;若字串是 ANSI 或 DBCS,則以位元組為單位。

Returns

SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR或SQL_INVALID_HANDLE。

Diagnostics

與 SQLDriverConnect 對任何輸入驗證錯誤的處理相同,但驅動程式管理器會使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleType 和 hDbcInfoToken 的 Handle。

備註

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

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

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

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