Compartilhar via


SQLDriverConnect

O driver ODBC SQL Server Native Client define atributos de conexão que substituem ou aprimoram palavras-chave de cadeia de conexão. Várias palavras-chave de cadeia de conexão têm valores padrão especificados pelo driver ODBC SQL Server Native Client.

Para obter uma lista das palavras-chave disponíveis no driver ODBC do SQL Server Native Client, consulte Usando palavras-chave de cadeia de conexão com SQL Server Native Client.

Para obter mais informações sobre SQL Server atributos de conexão e comportamentos padrão do driver, consulte SQLSetConnectAttr.

Para obter uma discussão sobre palavras-chave de cadeia de conexão válidas para SQL Server Native Client, consulte Usando palavras-chave de cadeia de conexão com SQL Server Native Client.

Quando o valor do SQLDriverConnect parâmetro DriverCompletion é SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE ou SQL_DRIVER_COMPLETE_REQUIRED, o driver ODBC SQL Server Native Client recupera valores palavra-chave da caixa de diálogo exibida. Se o valor palavra-chave for passado na cadeia de conexão e o usuário não alterar o valor do palavra-chave na caixa de diálogo, o driver ODBC SQL Server Native Client usará o valor da cadeia de conexão. Se o valor não for definido na cadeia de caracteres da conexão e o usuário não fizer nenhuma atribuição na caixa de diálogo, o driver usará o padrão.

SQLDriverConnect deve receber um WindowHandle válido quando qualquer valor DriverCompletion exigir (ou pode exigir) a exibição da caixa de diálogo de conexão do driver. Um identificador inválido retorna SQL_ERROR.

Especifique as palavras-chave DRIVER ou DSN. O ODBC declara que um driver usa a que está mais à esquerda dessas duas palavras-chave e ignora a outra se ambas estão especificadas. Se DRIVER for especificado ou for o mais à esquerda dos dois, e o valor do SQLDriverConnect parâmetro DriverCompletion for SQL_DRIVER_NOPROMPT, o palavra-chave SERVER e um valor apropriado serão necessários.

Quando SQL_DRIVER_NOPROMPT é especificado, as palavras-chave de autenticação de usuário devem estar presentes com valores. O driver assegura que a cadeia de caracteres "Trusted_Connection=yes" ou as palavras-chave UID e PWD estão presentes.

Se o valor do parâmetro DriverCompletion for SQL_DRIVER_NOPROMPT ou SQL_DRIVER_COMPLETE_REQUIRED e o idioma ou banco de dados vier da cadeia de conexão e for inválido, SQLDriverConnect retornará SQL_ERROR.

Se o valor do parâmetro DriverCompletion for SQL_DRIVER_NOPROMPT ou SQL_DRIVER_COMPLETE_REQUIRED e o idioma ou o banco de dados vier das definições de fonte de dados ODBC e for inválido, SQLDriverConnect usará o idioma ou o banco de dados padrão para a ID de usuário especificada e retornará SQL_SUCCESS_WITH_INFO.

Se o valor do parâmetro DriverCompletion for SQL_DRIVER_COMPLETE ou SQL_DRIVER_PROMPT e se o idioma ou banco de dados for inválido, SQLDriverConnect será reproduzida a caixa de diálogo.

Suporte de SQLDriverConnect à alta disponibilidade e recuperação de desastre

Para obter mais informações sobre como usar SQLDriverConnect para se conectar a um cluster de Grupos de Disponibilidade Always On, consulte suporte SQL Server Native Client para alta disponibilidade, recuperação de desastre.

Suporte de SQLDriverConnect a SPNs (nomes de entidade de serviço)

SQLDDriverConnect usará a caixa de diálogo Logon ODBCquando a solicitação estiver habilitada. Isto permite que os SPNs sejam inseridos no servidor principal e no seu parceiro de failover.

SQLDriverConnect aceitará as novas palavras-chave ServerSPN de cadeia de conexão e FailoverPartnerSPN, e reconhecerá os novos atributos de conexão SQL_COPT_SS_SERVER_SPN e SQL_COPT_SS_FAILOVER_PARTNER_SPN.

Quando um valor de atributo de conexão é especificado mais de uma vez, um valor definido programaticamente tem precedência sobre o valor em um DSN e um valor em uma cadeia de caracteres de conexão. Um valor em um DSN tem precedência sobre um valor em uma cadeia de caracteres de conexão.

Quando uma conexão é aberta, SQL Server Native Client define SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD para o método de autenticação usado para abrir a conexão.

Para obter mais informações sobre SPNs, consulte SPNs (Nomes de Entidade de Serviço) em Conexões de Cliente (ODBC).

Exemplos

A chamada a seguir ilustra a menor quantidade de dados necessária para SQLDriverConnect:

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

As seguintes cadeias de conexão ilustram os dados mínimos necessários quando o valor do parâmetro DriverCompletion é SQL_DRIVER_NOPROMPT:

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

Consulte Também

Função SQLDriverConnect
ODBC API Implementation Details
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)