SQLGetPoolID İşlevi

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

Summary
SQLGetPoolID havuz ID'sini alır.

Syntax

  
SQLRETURN  SQLGetPoolID (  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                POOLID *              pPoolID );

Arguments

hDbcInfoToken
[Giriş] Tüm bağlantı bilgilerini içeren token handle.

pPoolID
[Çıkış] Havuz ID, birbirinin yerine kullanılabilen (ek bir sıfırlama gerektirebilir) bağlantı setini tanımlamak için kullanılır.

İadeler

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR veya SQL_INVALID_HANDLE.

Diagnostics

SQLGetPoolID SQL_ERROR veya SQL_SUCCESS_WITH_INFO döndürdüğünde, Sürücü Yöneticisi SQL_HANDLE_DBC_INFO_TOKEN HandleType ve hDbcInfoTokenHandle kullanır.

Remarks

SQLGetPoolID , bağlantı bilgisi kümesi verildiğinde havuz kimliğini elde etmek için kullanılır ( SQLSetConnectAttrForDbcInfo, SQLSetDriverConnectInfo ve SQLSetConnectInfo'dan). Bu havuz kimliği, birbirinin yerine kullanılabilecek (ek bir sıfırlama gerektirebilir) bir bağlantı setini tanımlamak için kullanılır. Havuz ID, o bağlantı grubunun bağlantı havuzunu tanımlamak için kullanılı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.

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.

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

İlgili içerik

  • Last updated on