SQLBrowseConnect

O SQLBrowseConnect usa palavras-chave que podem ser categorizadas em três níveis de informações de conexão. Para cada palavra-chave, a tabela a seguir indica se uma lista de valores válidos é retornada e se a palavra-chave é opcional.

Nível 1

Palavra-chave	Lista retornada?	Opcional?	Descrição
DSN	Não aplicável	Não	Nome da fonte de dados retornada por SQLDataSources. A palavra-chave DSN não poderá ser usada se a palavra-chave DRIVER for usada.
MOTORISTA	Não aplicável	Não	Microsoft?? O nome do driver ODBC do SQL Server Native Client é {SQL Server Native Client 11}. A palavra-chave DRIVER não poderá ser usada se a palavra-chave DSN for usada.

Nível 2

Palavra-chave	Lista retornada?	Opcional?	Descrição
SERVIDOR	Sim	Não	Nome do servidor na rede na qual reside a fonte de dados. O termo "(local)" pode ser inserido como o servidor, nesse caso, uma cópia local do SQL Server pode ser usada, mesmo quando esta é uma versão não em rede.
Identificador Único (UID)	Não	Sim	ID de logon do usuário.
PWD	Não	Sim (depende do usuário)	Senha especificada pelo usuário.
APLICAÇÃO	Não	Sim	Nome do aplicativo que chama SQLBrowseConnect.
WSID	Não	Sim	ID da estação de trabalho. Normalmente, esse é o nome de rede do computador no qual o aplicativo é executado.

Nível 3

Palavra-chave	Lista retornada?	Opcional?	Descrição
BASE DE DADOS	Sim	Sim	Nome do banco de dados do SQL Server.
IDIOMA	Sim	Sim	Idioma nacional usado pelo SQL Server.

SQLBrowseConnect ignora os valores das palavras-chave DATABASE e LANGUAGE armazenadas nas definições da fonte de dados ODBC. Se o banco de dados ou idioma especificado na cadeia de conexão passada para SQLBrowseConnect for inválido , SQLBrowseConnect retornará SQL_NEED_DATA e os atributos de conexão de nível 3.

Os atributos a seguir, que são definidos chamando SQLSetConnectAttr, determinam o conjunto de resultados retornado por SQLBrowseConnect.

Atributo	Descrição
SQL_COPT_SS_BROWSE_CONNECT	Se estiver definido como SQL_MORE_INFO_YES, SQLBrowseConnect retornará uma cadeia de caracteres estendida de propriedades do servidor. Veja a seguir um exemplo de uma cadeia de caracteres estendida retornada por SQLBrowseConnect:ServerName\InstanceName; Clustered:Não; Versão:8.00.131 Nesta cadeia de caracteres, os ponto e vírgula separam várias informações sobre o servidor. Use vírgulas para separar instâncias de servidor diferentes.
SQL_COPT_SS_BROWSE_SERVER	Se um nome de servidor for especificado, SQLBrowseConnect retornará informações para o servidor especificado. Se SQL_COPT_SS_BROWSE_SERVER estiver definido como NULL, SQLBrowseConnect retornará informações para todos os servidores no domínio. Devido a problemas de rede, o SQLBrowseConnect pode não receber uma resposta oportuna de todos os servidores. Portanto, a lista de servidores retornados pode variar para cada solicitação.
SQL_COPT_SS_BROWSE_CACHE_DATA	Quando o atributo SQL_COPT_SS_BROWSE_CACHE_DATA é definido como SQL_CACHE_DATA_YES, você pode buscar dados em partes quando o comprimento do buffer não é grande o suficiente para manter o resultado. Esse comprimento é especificado no argumento BufferLength para SQLBrowseConnect. SQL_NEED_DATA é retornado quando mais dados estão disponíveis. SQL_SUCCESS é retornado quando não há mais dados a serem recuperados. O padrão é SQL_CACHE_DATA_NO.

Suporte do SQLBrowseConnect para alta disponibilidade, recuperação de desastre

Para obter mais informações sobre como usar o SQLBrowseConnect para se conectar a um cluster de Grupos de Disponibilidade AlwaysOn, consulte o suporte ao cliente nativo do SQL Server para alta disponibilidade e recuperação de desastre.

Suporte do SQLBrowseConnect para SPNs (Nomes de Entidade de Serviç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).

Histórico de alterações

Conteúdo atualizado
SQL_COPT_SS_BROWSE_CACHE_DATA documentado.

Consulte Também

Função SQLBrowseConnect
Detalhes da implementação da API do ODBC