SQLSetDriverConnectInfo İşlevi

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

Summary
SQLSetDriverConnectInfo, bir uygulamanın SQLDriverConnect çağrısı için bağlantı bilgi belirtekosuna bağlantı dizesi'i ayarlamak için kullanılır.

Syntax

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );  

Arguments

TokenHandle
[Giriş] Token sapı.

InConnectionString
[Giriş] Tam bir bağlantı dizesi (SQLDriverConnect'teki "Yorumlar" bölümündeki sözdizimi bkzınız), kısmi bir bağlantı dizesi veya boş bir string.

StringLength1
[Giriş] *InConnectionString'in uzunluğu, eğer dizi Unicode'sa, karakter olarak, eğer dizi ANSI veya DBCS ise baytlarla.

İadeler

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR veya SQL_INVALID_HANDLE.

Diagnostics

Giriş doğrulama hatalarıyla ilgili SQLDriverConnect ile aynı, ancak Driver Manager SQL_HANDLE_DBC_INFO_TOKEN HandleType ve hDbcInfoTokenHandle kullanır.

Remarks

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.