SQLDriverConnect

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

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 do 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 exigir (ou puder 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, o 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, o 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, o 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 ao SQL Server Native Client para alta disponibilidade, recuperação de desastre.

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

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

O 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 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 ODBC (conexões de cliente).

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"  

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)