Fungsi SQLSetConnectInfo

Kesesuaian
Versi Diperkenalkan: Kepatuhan Standar ODBC 3.81: ODBC

Ringkasan
SQLSetConnectInfo digunakan untuk mengatur sumber data, ID pengguna, dan kata sandi ke dalam token info koneksi untuk panggilan SQLConnect aplikasi.

Sintaks

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );  

Argumen

TokenHandle
[Input] Handel token.

ServerName
[Input] Nama sumber data. Data mungkin terletak pada komputer yang sama dengan program, atau pada komputer lain di suatu tempat pada jaringan. Untuk informasi tentang cara aplikasi memilih sumber data, lihat Memilih Sumber Data atau Driver.

NameLength1
[Input] Panjang *ServerName dalam karakter.

UserName
[Input] Pengidentifikasi pengguna.

NameLength2
[Input] Panjang *UserName dalam karakter.

Autentikasi
[Input] String autentikasi (biasanya kata sandi).

NameLength3
[Input] Panjang *Autentikasi dalam karakter.

Mengembalikan

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.

Diagnostik

Sama seperti SQLConnect untuk kesalahan validasi input, kecuali bahwa Manajer Driver akan menggunakan HandleType SQL_HANDLE_DBC_INFO_TOKEN dan HandelhDbcInfoToken.

Keterangan

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

Setiap kali driver kembali 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 yang Sadar Driver
Mengembangkan kesadaran Connection-Pool dalam Driver ODBC