Fungsi SQLSetConnectAttrForDbcInfo

Kesesuaian
Versi yang diperkenalkan: Kepatuhan standar ODBC 3.81: ODBC

Summary
SQLSetConnectAttrForDbcInfo sama dengan SQLSetConnectAttr, tetapi menetapkan atribut pada token informasi koneksi, bukan pada handle koneksi.

Syntax

  
SQLRETURN  SQLSetConnectAttrForDbcInfo(  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                SQLINTEGER            Attribute,  
                SQLPOINTER            ValuePtr,  
                SQLINTEGER            StringLength );

Arguments

hDbcInfoToken
[Input] Pegangan token.

Atribut
[Input] Atribut ke set. Daftar atribut valid spesifik driver dan sama seperti SQLSetConnectAttr.

ValuePtr
[Input] Pointer ke nilai yang akan diasosiasikan dengan Atribut. Tergantung pada nilai Atribut,ValuePtr akan berupa nilai bilangan bulat tanpa tanda 32-bit atau akan menunjuk ke string karakter yang diakhiri null. Perlu dicatat bahwa jika argumen Attribute adalah nilai spesifik driver, nilai di ValuePtr mungkin berupa bilangan bulat bertanda.

StringLength
[Input] Jika Atribut adalah atribut yang ditentukan ODBC dan ValuePtr menunjuk ke string karakter atau buffer biner, argumen ini harus panjangnya *ValuePtr. Untuk data string karakter, argumen ini harus berisi jumlah byte dalam string.

Jika Atribut adalah atribut yang ditentukan ODBC dan ValuePtr adalah bilangan bulat, StringLength diabaikan.

Jika Atribut adalah atribut yang ditentukan driver, aplikasi menunjukkan sifat atribut ke Driver Manager dengan mengatur argumen StringLength . StringLength dapat memiliki nilai berikut:

  • Jika ValuePtr adalah penunjuk ke string karakter, maka StringLength adalah panjang string atau SQL_NTS.

  • Jika ValuePtr adalah penunjuk ke buffer biner, maka aplikasi menempatkan hasil makro SQL_LEN_BINARY_ATTR(length) di StringLength. Ini menempatkan nilai negatif dalam StringLength.

  • Jika ValuePtr adalah penunjuk ke nilai selain string karakter atau string biner, string StringLength harus memiliki nilai SQL_IS_POINTER.

  • Jika ValuePtr berisi nilai panjang tetap, maka StringLength adalah SQL_IS_INTEGER atau SQL_IS_UINTEGER, yang sesuai.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, atau SQL_INVALID_HANDLE.

Diagnostics

Sama seperti SQLSetConnectAttr, kecuali Driver Manager akan menggunakan HandleType SQL_HANDLE_DBC_INFO_TOKEN dan HandlehDbcInfoToken.

Remarks

SQLSetConnectAttrForDbcInfo sama dengan SQLSetConnectAttr, tetapi menetapkan atribut pada token informasi koneksi, bukan pada handle koneksi. Misalnya, jika SQLSetConnectAttr tidak mengenali atribut, SQLSetConnectAttrForDbcInfo juga harus mengembalikan SQL_ERROR untuk atribut tersebut.

Setiap kali driver mengembalikan SQL_ERROR atau SQL_INVALID_HANDLE, driver harus mengabaikan atribut ini untuk menghitung ID pool. Selain itu, Driver Manager akan memperoleh informasi diagnostik dari hDbcInfoToken, dan mengembalikan SQL_SUCCESS_WITH_INFO ke aplikasi dalam SQLConnect dan SQLDriverConnect. Oleh karena itu, sebuah aplikasi dapat mengambil detail mengapa beberapa atribut tidak dapat diatur.

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