符合性
推出版本:ODBC 3.8 標準合規:ODBC
總結
若池中無法重複使用連線,則使用 SQLPoolConnect 建立新的連線。
Syntax
SQLRETURN SQLPoolConnect(
SQLHDBC hDbc,
SQLHDBC_INFO_TOKEN hDbcInfoToken,
WCHAR * wszOutConnectString,
SQLSMALLINT cchConnectStringBuffer,
SQLSMALLINT * cchConnectStringLen );
論點
hDbc
[輸入]連接把手。
hDbcInfoToken
[輸入]新應用程式連接請求的權杖句柄。
wszOutConnectString
[輸出]指標指向已完成的 連接字串 緩衝區。 成功連接目標資料來源後,此緩衝區會包含已完成的 連接字串。 應用程式應為此緩衝區配置至少 1,024 個字元。
如果 wszOutConnectString 是 NULL,cchConnectStringLen 仍會回傳 wszOutConnectString 指向緩衝區中可返回的字元總數(不含字元資料的空終止字元)。
cchConnectStringBuffer
[輸入]*wszOutConnectString 緩衝區的長度,以字元為單位。
cchConnectStringLen
[輸出]指標指向緩衝區,回傳 *wszOutConnectString 中可返回的字元總數(不含空終止字元)。 若可回傳的字元數大於或等於 cchConnectStringBuffer,則 *wszOutConnectString 中完成的 連接字串 會被截斷為 cchConnectStringBuffer 減去一個空終止字元的長度。
Returns
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR,或SQL_INVALID_HANDLE。
Diagnostics
類似 SQLDriverConnect 用於任何輸入驗證錯誤,但驅動程式管理器會使用 SQL_HANDLE_DBC_INFO_TOKEN 的 HandleType 與 hDbcInfoToken 的 Handle。
備註
驅動程式管理器保證 hDbc 與 hDbcInfoToken 的父 HENV 位址是相同的。
與 SQLDriverConnect 不同,它沒有 DriverCompletion 參數來提示使用者輸入連接資訊。 在池化情境中不允許提示對話。
應用程式不應直接呼叫此函式。 支援驅動程式感知連線池的 ODBC 驅動程式必須實作此功能。
每當驅動返回 SQL_ERROR 或 SQL_INVALID_HANDLE,驅動管理員會將錯誤傳回應用程式(以 SQLConnect 或 SQLDriverConnect 進行)。
每當驅動程式返回SQL_SUCCESS_WITH_INFO時,驅動程式管理器會從 hDbcInfoToken 取得診斷資訊,並以 SQLConnect 和 SQLDriverConnect 將SQL_SUCCESS_WITH_INFO回傳給應用程式。
當應用程式使用 SQLConnect 時, wszOutConnectString 會是 NULL 緩衝區(最後三個參數都會設為 NULL、0、NULL)。 否則,驅動程式必須回傳輸出的 連接字串,該字串會回傳到應用程式的 SQLDriverConnect 函式呼叫中。
請包含 sqlspi.h 以開發 ODBC 驅動程式。