Compartilhar via


SQLGetConnectAttr

O driver ODBC do SQL Server Native Client define atributos de conexão específicos de driver. Alguns dos atributos estão disponíveis a SQLGetConnectAttr, e a função é usada para informar as configurações atuais. Os valores informados em relação a esses atributos não são garantidos até que uma conexão seja estabelecida ou o atributo seja definido usando SQLSetConnectAttr.

Para obter mais informações sobre atributos, consulte SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

O atributo SQL_COPT_SS_CONNECTION_DEAD informa o estado de uma conexão com um servidor. O driver consulta a rede quanto ao estado atual da conexão.

ObservaçãoObservação

O atributo de conexão ODBC padrão SQL_ATTR_CONNECTION_DEAD retorna o estado mais recente da conexão. Esse talvez não seja o estado da 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 ao processamento de instrução.

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 de desempenho do driver atuais. SQLGetConnectAttr retornará NULL se registro em log do desempenho não for habilitado. As estatísticas na estrutura SQLPERF não são atualizadas dinamicamente pelo driver. Chame SQLGetConnectAttr sempre que as estatísticas de desempenho precisarem ser atualizadas.

Valor

Descrição

NULL

O registro em 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 retorna TRUE caso o registro em log das consultas demoradas em execução esteja habilitado. A solicitação retorna FALSE caso registro em log da consulta não esteja ativo.

SQL_COPT_SS_USER_DATA

O atributo SQL_COPT_SS_USER_DATA recupera o ponteiro dos dados de usuário. Os dados de usuário são armazenados na memória do cliente e registrados por conexão. Caso o ponteiro de dados do usuário não seja definido, SQL_UD_NOTSET, um ponteiro NULL, é retornado.

Valor

Descrição

SQL_UD_NOTSET

Nenhum ponteiro de dados do usuário é definido.

Qualquer outro valor

Um ponteiro para os dados do usuário.

Suporte do SQLGetConnectAttr a SPNs (Nomes da Entidade de Serviç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 estes valores).

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

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

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