Fungsi SQLSetConnectInfo

Kesesuaian
Versi yang diperkenalkan: Kepatuhan standar ODBC 3.81: ODBC

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

Syntax

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

Arguments

TokenHandle
[Input] Pegangan token.

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

NameLength1
[Masukan] Panjang *ServerName dalam karakter.

UserName
[Masukan] Pengidentifikasi pengguna.

NameLength2
[Masukan] Panjang *UserName dalam karakter.

Authentication
[Masukan] String autentikasi (biasanya kata sandi).

NameLength3
[Masukan] Panjang *Otentikasi dalam karakter.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.

Diagnostics

Sama seperti SQLConnect untuk kesalahan validasi input, kecuali Driver Manager akan menggunakan HandleType SQL_HANDLE_DBC_INFO_TOKEN dan HandlehDbcInfoToken.

Remarks

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

Setiap kali driver mengembalikan SQL_SUCCESS_WITH_INFO, Driver Manager akan memperoleh informasi diagnostik dari hDbcInfoToken, dan mengembalikan SQL_SUCCESS_WITH_INFO ke aplikasi dalam SQLConnect dan SQLDriverConnect.

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

Sertakan sqlspi.h untuk pengembangan driver ODBC.

Konten terkait

  • Last updated on