SQLSetConnectInfo 函式
一致性
引進的版本：ODBC 3.81 標準合規性：ODBC
摘要
SQLSetConnectInfo 可用來將資料來源、使用者識別碼和密碼設定為應用程式的 SQLConnect 呼叫連線資訊權杖。
語法
SQLRETURN SQLSetConnectInfo(
SQLHDBC_INFO_TOKEN TokenHandle,
WCHAR * ServerName,
SQLSMALLINT NameLength1,
WCHAR * UserName,
SQLSMALLINT NameLength2,
WCHAR * Authentication,
SQLSMALLINT NameLength3 );
引數
TokenHandle
[輸入]權杖控制碼。
ServerName
[輸入]資料來源名稱。 資料可能和程式位於相同的電腦上，也可能位於網路內的其他電腦上。 如需應用程式如何選擇資料來源的資訊，請參閱 選擇資料來源或驅動程式 。
NameLength1
[輸入]字元的 * ServerName 長度。
UserName
[輸入]使用者識別碼。
NameLength2
[輸入]字元的 * UserName 長度。
驗證
[輸入]驗證字串 （通常是密碼）。
NameLength3
[輸入]* 以字元表示驗證 的長度。
傳回
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR或SQL_INVALID_HANDLE。
診斷
與 輸入驗證錯誤的 SQLConnect 相同，不同之處在于驅動程式管理員會使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleType 和 hDbcInfoToken 的 控制碼 。
備註
每當驅動程式傳回SQL_ERROR或SQL_INVALID_HANDLE時，驅動程式管理員就會將錯誤傳回應用程式（在 SQLConnect 或 SQLDriverConnect 中）。
每當驅動程式傳回SQL_SUCCESS_WITH_INFO時，驅動程式管理員就會從 hDbcInfoToken 取得診斷資訊，並將SQL_SUCCESS_WITH_INFO傳回 SQLConnect 和 SQLDriverConnect 中的 應用程式。
應用程式不應該直接呼叫此函式。 支援驅動程式感知連接共用的 ODBC 驅動程式必須實作此函式。
包含 sqlspi.h 以進行 ODBC 驅動程式開發。