SQLPoolConnect İşlevi

Uygunluk
Tanıtılan Sürüm: ODBC 3.8 Standartlara Uyum: ODBC

Summary
Havuzdaki hiçbir bağlantı tekrar kullanılamazsa SQLPoolConnect yeni bir bağlantı oluşturmak için kullanılır.

Syntax

  
SQLRETURN  SQLPoolConnect(  
                SQLHDBC              hDbc,  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              wszOutConnectString,  
                SQLSMALLINT          cchConnectStringBuffer,  
                SQLSMALLINT *        cchConnectStringLen );

Arguments

hDbc
[Giriş] Bağlantı kolunu.

hDbcInfoToken
[Giriş] Yeni uygulama bağlantı talebi için token kolu.

wszOutConnectString
[Çıkış] Tamamlanmış bağlantı dizesi için bir tampona işaret edin. Hedef veri kaynağına başarılı bağlantı sağlandığında, bu tampon tamamlanmış bağlantı dizesi'i içerir. Uygulamalar bu tampon için en az 1.024 karakter ayırmalıdır.

wszOutConnectString NULL ise, cchConnectStringLen yine de wszOutConnectString tarafından işaretlenen tamponda döndürülebilecek toplam karakter sayısını (karakter verisi için null-sonlama karakteri hariç) döndürecektir.

cchConnectStringBuffer
[Giriş] *wszOutConnectString tamponunun uzunluğu, karakter cinsinden.

cchConnectStringLen
[Çıkış] *wszOutConnectString içinde döndürülebilecek toplam karakter sayısını (null-termination karakteri hariç) döndürmek için bir tampona işaret et. Eğer döndürülebilecek karakter sayısı cchConnectStringBuffer'dan büyük veya eşitse, *wszOutConnectString içindeki tamamlanmış bağlantı dizesi cchConnectStringBuffer olarak kısaltılır; null-terminasyon karakterinin uzunluğu çıkarılır.

İadeler

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR ya da SQL_INVALID_HANDLE.

Diagnostics

Herhangi bir giriş doğrulama hatası için SQLDriverConnect'e benzer, ancak Driver Manager SQL_HANDLE_DBC_INFO_TOKEN HandleType ve hDbcInfoTokenHandle kullanır.

Remarks

Sürücü Yöneticisi, hDbc ve hDbcInfoToken'ın ana HENV kullanıcı tanımının aynı olduğunu garanti eder.

SQLDriverConnect'in aksine, kullanıcıların bağlantı bilgisini girmesini isteyen DriverCompletion argümanı yoktur. Havuzlama senaryosunda bir yönlendirme diyalogu yasaktır.

Uygulamalar bu fonksiyonu doğrudan çağırmamalıdır. Sürücüye duyarlı bağlantı havuzunu destekleyen bir ODBC sürücüsü bu fonksiyonu uygulamalıdır.

Bir sürücü SQL_ERROR veya SQL_INVALID_HANDLE döndürdüğünde, Sürücü Yöneticisi hatayı uygulamaya ( SQLConnect veya SQLDriverConnect'te) döndürür.

Bir sürücü SQL_SUCCESS_WITH_INFO döndürdüğünde, Sürücü Yöneticisi tanı bilgilerini hDbcInfoToken'dan alır ve SQL_SUCCESS_WITH_INFO SQLConnect ile SQLDriverConnect içinde uygulamaya geri gönderir.

Bir uygulama SQLConnect kullandığında, wszOutConnectString bir NULL tampon olur (son üç parametrenin hepsi NULL, 0, NULL olarak ayarlanır). Aksi takdirde, sürücü çıkış bağlantı dizesi'i geri göndermelidir ve bu dizi uygulamanın SQLDriverConnect Fonksiyon çağrısına geri gönderilir.

ODBC sürücü geliştirme için sqlspi.h ekleyin.

İlgili içerik

  • Last updated on