Fungsi SQLSetDriverConnectInfo

  • Artikel

Kesesuaian
Versi Diperkenalkan: Kepatuhan Standar ODBC 3.81: ODBC

Ringkasan
SQLSetDriverConnectInfo digunakan untuk mengatur string koneksi ke dalam token info koneksi untuk panggilan SQLDriverConnect aplikasi.

Sintaks

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

Argumen

TokenHandle
[Input] Handel token.

InConnectionString
[Input] String koneksi lengkap (lihat sintaks dalam "Komentar" di SQLDriverConnect), string koneksi parsial, atau string kosong.

StringLength1
[Input] Panjang *InConnectionString, dalam karakter jika string adalah Unicode, atau byte jika string adalah ANSI atau DBCS.

Kembali

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.

Diagnostik

Sama seperti SQLDriverConnect yang terkait dengan kesalahan validasi input apa pun, kecuali bahwa Manajer Driver akan menggunakan HandleType SQL_HANDLE_DBC_INFO_TOKEN dan HandelhDbcInfoToken.

Keterangan

Setiap kali driver mengembalikan SQL_ERROR atau SQL_INVALID_HANDLE, Manajer Driver mengembalikan kesalahan ke aplikasi (di SQLConnect atau SQLDriverConnect).

Setiap kali driver mengembalikan SQL_SUCCESS_WITH_INFO, Manajer Driver akan mendapatkan informasi diagnostik dari hDbcInfoToken, dan mengembalikan SQL_SUCCESS_WITH_INFO ke aplikasi di SQLConnect dan SQLDriverConnect.

Aplikasi tidak boleh memanggil fungsi ini secara langsung. Driver ODBC yang mendukung pengumpulan koneksi sadar driver harus menerapkan fungsi ini.

Sertakan sqlspi.h untuk pengembangan driver ODBC.

Lihat Juga

Mengembangkan Driver ODBC
Pengumpulan Koneksi Sadar Driver
Mengembangkan Kesadaran Kumpulan Koneksi di Driver ODBC