符合性
推出版本: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 的 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 驅動程式。