SQLDriverConnect

Artigo
01/10/2024

Aplica-se a:SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System)

O driver ODBC do 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 do 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 o SQL Server Native Client.

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

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

Quando o valor do parâmetro SQLDriverConnectDriverCompletion é SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE ou SQL_DRIVER_COMPLETE_REQUIRED, o driver ODBC do SQL Server Native Client recupera valores de palavra-chave da caixa de diálogo exibida. Se o valor da palavra-chave for passado na cadeia de conexão e o usuário não alterar o valor da palavra-chave na caixa de diálogo, o driver ODBC do 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 requer (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 parâmetro SQLDriverConnectDriverCompletion for SQL_DRIVER_NOPROMPT, a 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 banco de dados vier das definições de fonte de dados ODBC e for inválido, SQLDriverConnect usará o idioma ou banco de dados padrão para o ID de usuário especificado 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 o banco de dados for inválido, SQLDriverConnect exibirá novamente a caixa de diálogo.

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

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

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

SQLDDriverConnect usará a caixa de diálogo Logon ODBC quando o prompt estiver habilitado. Isto permite que os SPNs sejam inseridos no servidor principal e no seu parceiro de failover.

SQLDriverConnect aceitará as novas palavras-chave de cadeia de conexão ServerSPN 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, o SQL Server Native Client define SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD ao método de autenticação usado para abrir a conexão.

Para obter mais informações sobre SPNs, consulte Nomes de entidade de serviço (SPNs) 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 cadeias de conexão a seguir ilustram 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"

Confira também

Função SQLDriverConnect
Detalhes da implementação da API do ODBC
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)