SQLSetConnectInfo İşlevi

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

Summary
SQLSetConnectInfo , bir uygulamanın SQLConnect çağrısı için bağlantı bilgi belirteğine veri kaynağı, kullanıcı kimliği ve şifre ayarlamak için kullanılır.

Syntax

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

Arguments

TokenHandle
[Giriş] Token sapı.

SunucuAdı
[Giriş] Veri kaynağı adı. Veriler programla aynı bilgisayarda veya ağdaki başka bir bilgisayarda bulunabilir. Bir uygulamanın veri kaynağını nasıl seçtiğine dair bilgi için Veri Kaynağı veya Sürücü Seçme bölümüne bakınız.

NameLength1
[Giriş] *Sunucu Adı karakter cinsinden.

UserName
[Giriş] Kullanıcı tanımlayıcısı.

NameLength2
[Giriş] *UserName karakter boyunca.

Authentication
[Giriş] Kimlik doğrulama dizisi (genellikle şifre).

NameLength3
[Giriş] *Kimlik doğrulama süresi karakter cinsinden.

İadeler

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR veya SQL_INVALID_HANDLE.

Diagnostics

Giriş doğrulama hataları için SQLConnect ile aynı, ancak Sürücü Yöneticisi SQL_HANDLE_DBC_INFO_TOKEN HandleType ve hDbcInfoTokenHandle kullanacaktı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.