SQLDriverConnect

Şunlar için geçerlidir: Sql ServerAzure SQL VeritabanıAzure Synapse AnalyticsAnalytics Platform Sistemi (PDW)Azure SQL Veritabanı

SQL Server Yerel İstemci ODBC sürücüsü, bağlantı dizesi anahtar sözcüklerini değiştiren veya geliştiren bağlantı özniteliklerini tanımlar. Birkaç bağlantı dizesi anahtar sözcüğü, SQL Server Yerel İstemci ODBC sürücüsü tarafından belirtilen varsayılan değerlere sahiptir.

SQL Server Yerel İstemci ODBC sürücüsünde kullanılabilen anahtar sözcüklerin listesi için bkz. SQL Server Native Clientile Bağlantı Dizesi Anahtar Sözcüklerini Kullanma .

SQL Server bağlantı öznitelikleri ve sürücü varsayılan davranışları hakkında daha fazla bilgi için bkz. SQLSetConnectAttr.

SQL Server Yerel İstemcisi için geçerli olan bağlantı dizesi anahtar sözcüklerinin tartışması için bkz. SQL Server Yerel İstemcisi ile Bağlantı Dizesi Anahtar Sözcüklerini Kullanma.

SQLDriverConnectDriverCompletion parametre değeri SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE veya SQL_DRIVER_COMPLETE_REQUIRED olduğunda, SQL Server Yerel İstemci ODBC sürücüsü görüntülenen iletişim kutusundan anahtar sözcük değerlerini alır. Anahtar sözcük değeri bağlantı dizesinde geçirilirse ve kullanıcı iletişim kutusundaki anahtar sözcüğün değerini değiştirmezse, SQL Server Yerel İstemci ODBC sürücüsü bağlantı dizesindeki değeri kullanır. Değer bağlantı dizesinde ayarlanmazsa ve kullanıcı iletişim kutusunda atama yapmazsa, sürücü varsayılan değeri kullanır.

SQLDriverConnect, herhangi bir DriverCompletion değeri sürücünün bağlantı iletişim kutusunun görüntülenmesini gerektirdiğinde (veya gerektirebilirse) geçerli bir WindowHandle verilmelidir. Geçersiz tanıtıcı SQL_ERROR döndürür.

DRIVER veya DSN anahtar sözcüklerini belirtin. ODBC, bir sürücünün bu iki anahtar sözcüğün en solunu kullandığını ve her ikisi de belirtilirse diğerini yoksaydığını belirtir. DRIVER belirtilirse veya ikisinin en solundaysa ve SQLDriverConnectDriverCompletion parametre değeri SQL_DRIVER_NOPROMPT ise, SERVER anahtar sözcüğü ve uygun bir değer gerekir.

SQL_DRIVER_NOPROMPT belirtildiğinde, kullanıcı kimlik doğrulama anahtar sözcüklerinin değerlerle mevcut olması gerekir. Sürücü, "Trusted_Connection=yes" dizesinin veya hem UID hem de PWD anahtar sözcüklerinin mevcut olmasını sağlar.

DriverCompletion parametre değeri SQL_DRIVER_NOPROMPT veya SQL_DRIVER_COMPLETE_REQUIRED ise ve dil veya veritabanı bağlantı dizesinden geliyorsa ve geçersizse, SQLDriverConnect SQL_ERROR döndürür.

DriverCompletion parametre değeri SQL_DRIVER_NOPROMPT veya SQL_DRIVER_COMPLETE_REQUIRED ise ve dil veya veritabanı ODBC veri kaynağı tanımlarından geliyorsa ve geçersizse, SQLDriverConnect belirtilen kullanıcı kimliği için varsayılan dili veya veritabanını kullanır ve SQL_SUCCESS_WITH_INFO döndürür.

DriverCompletion parametre değeri SQL_DRIVER_COMPLETE veya SQL_DRIVER_PROMPT ve dil veya veritabanı geçersizse SQLDriverConnect iletişim kutusunu yeniden gösterir.

Yüksek Kullanılabilirlik, Olağanüstü Durum Kurtarma için SQLDriverConnect Desteği

Always On kullanılabilirlik grupları kümesine bağlanmak için SQLDriverConnect kullanma hakkında daha fazla bilgi için bkz. YÜKSEK Kullanılabilirlik için SQL Server Yerel İstemci Desteği, Olağanüstü Durum Kurtarma.

Hizmet Asıl Adları (SPN' ler) için SQLDriverConnect Desteği

SQLDDriverConnect, istem etkinleştirildiğinde ODBC Oturum Açma iletişim kutusunu kullanır. Bu, hem asıl sunucu hem de yük devretme ortağı için SPN'lerin girilmesine olanak tanır.

SQLDriverConnect, ServerSPN ve FailoverPartnerSPNyeni bağlantı dizesi anahtar sözcüklerini kabul eder ve SQL_COPT_SS_SERVER_SPN ve SQL_COPT_SS_FAILOVER_PARTNER_SPN yeni bağlantı özniteliklerini tanır.

Bir bağlantı özniteliği değeri birden çok kez belirtildiğinde, program aracılığıyla ayarlanan bir değer bir DSN'deki değerden ve bağlantı dizesindeki değerden önceliklidir. DSN'deki bir değer, bağlantı dizesindeki bir değerden önceliklidir.

Bir bağlantı açıldığında, SQL Server Yerel İstemcisi SQL_COPT_SS_MUTUALLY_AUTHENTICATED ayarlar ve bağlantıyı açmak için kullanılan kimlik doğrulama yöntemine SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD.

SPN'ler hakkında daha fazla bilgi için bkz. İstemci Bağlantıları (ODBC)Hizmet Asıl Adları (SPN) .

Örnekler

Aşağıdaki çağrı, SQLDriverConnectiçin gereken en az miktarda veriyi gösterir:

SQLDriverConnect(hdbc, hwnd,  
    (SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,  
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);  

DriverCompletion parametre değeri SQL_DRIVER_NOPROMPT olduğunda aşağıdaki bağlantı dizeleri gereken en düşük verileri gösterir:

"DSN=Human Resources;Trusted_Connection=yes"  
  
"FILEDSN=HR_FDSN;Trusted_Connection=yes"  
  
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"  

Ayrıca Bkz.

SQLDriverConnect İşlevi
ODBC API Uygulama Ayrıntıları
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)