Compartilhar via

SQLGetConnectAttr

O driver ODBC do SQL Server Native Client define atributos de conexão específicos do driver. Alguns dos atributos estão disponíveis SQLGetConnectAttre a função é usada para relatar suas configurações atuais. Os valores relatados para esses atributos não são garantidos até que uma conexão tenha sido feita ou o atributo tenha sido definido usando SQLSetConnectAttr.

Este tópico lista os atributos somente leitura. Para obter informações sobre os outros atributos de conexão específicos do driver ODBC do SQL Server Native Client, consulte SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

O atributo SQL_COPT_SS_CONNECTION_DEAD relata o estado de uma conexão com um servidor. O driver consulta a rede para o estado atual da conexão.

Observação

O atributo de conexão ODBC padrão SQL_ATTR_CONNECTION_DEAD retorna o estado mais recente da conexão. Pode não ser o estado de conexão atual.

Valor Descrição
SQL_CD_TRUE A conexão com o servidor foi perdida.
SQL_CD_FALSE A conexão está aberta e disponível para processamento de instruções.

SQL_COPT_SS_CLIENT_CONNECTION_ID

O atributo SQL_COPT_SS_CLIENT_CONNECTION_ID recupera a ID de conexão do cliente, que pode ser usada para localizar:

  • Informações de diagnóstico no log XEvents, quando habilitadas.

  • Informações de erro de conexão no buffer do anel de conexão.

  • Informações de diagnóstico nos logs de rastreamento de acesso a dados, quando habilitadas.

Para obter mais informações, consulte Acessar informações de diagnóstico no log de eventos estendidos.

Valor Descrição
SQL_ERROR Falha na conexão.
SQL_SUCCESS A conexão foi bem-sucedida. A ID de conexão do cliente será encontrada no buffer de saída.

SQL_COPT_SS_PERF_DATA

O atributo SQL_COPT_SS_PERF_DATA retorna um ponteiro para uma estrutura SQLPERF que contém as estatísticas atuais de desempenho do driver. SQLGetConnectAttr retornará NULL se o log de desempenho não estiver habilitado. As estatísticas na estrutura SQLPERF não são atualizadas dinamicamente pelo driver. Chame SQLGetConnectAttr cada vez que as estatísticas de desempenho precisarem ser atualizadas.

Valor Descrição
NULO O log de desempenho não está habilitado.
Qualquer outro valor Um ponteiro para uma estrutura SQLPERF.

SQL_COPT_SS_PERF_QUERY

O atributo SQL_COPT_SS_PERF_QUERY retornará TRUE se o registro em log de consultas de execução longa estiver habilitado. A solicitação retornará FALSE se o log de consulta não estiver ativo.

SQL_COPT_SS_USER_DATA

O atributo SQL_COPT_SS_USER_DATA recupera o ponteiro de dados do usuário. Os dados do usuário são armazenados na memória de propriedade do cliente e registrados por conexão. Se o ponteiro de dados do usuário não tiver sido definido, SQL_UD_NOTSET, um ponteiro NULL, será retornado.

Valor Descrição
SQL_UD_NOTSET Nenhum ponteiro de dados do usuário está definido.
Qualquer outro valor Um ponteiro para os dados do usuário.

Suporte do SQLGetConnectAttr para SPNs (Nomes de Entidade de Serviço)

O SQLGetConnectAttr pode ser usado para consultar o valor dos novos atributos de conexão SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. (SQLGetConnectOption também pode ser usado para consultar esses valores.)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD só está disponível para conexões abertas que usam a Autenticação do Windows.

Se SQL_COPT_SS_SERVER_SPN ou SQL_COPT_SS_FAILOVER_PARTNER não tiver sido definido, o valor padrão (uma cadeia de caracteres vazia) será retornado.

Para obter mais informações sobre SPNs, consulte SPNs (nomes de entidade de serviço) em ODBC (conexões de cliente).

Consulte Também

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

  • Last updated on