Partilhar via


SQLBrowseConnect

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/D

Não

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.

DRIVER

N/D

Não

O nome do driver ODBC do Microsoft® SQL Server Native Client é {SQL Server Native Client 10}. A palavra-chave DRIVER não pode ser usada se a palavra-chave DSN for usada.

Nível 2

Palavra-chave

Lista retornada?

Opcional?

Descrição

SERVER

Sim

Não

O nome do servidor na rede onde a fonte de dados reside. O termo "(local)" pode ser inserido como o servidor; nesse caso uma cópia local do SQL Server pode ser usada, mesmo quando se trata de uma versão sem-rede.

UID

Não

Sim

ID de logon do usuário.

PWD

Não

Sim (depende do usuário)

Senha especificada pelo usuário.

APP

Não

Sim

O nome do aplicativo que chama SQLBrowseConnect.

WSID

Não

Sim

ID da estação de trabalho. Normalmente, é o nome de rede do computador no qual o aplicativo é executado.

Nível 3

Palavra-chave

Lista retornada?

Opcional?

Descrição

DATABASE

Sim

Sim

O nome do banco de dados do SQL Server.

LANGUAGE

Sim

Sim

O idioma nacional usado por SQL Server.

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

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

Atributo

Descrição

SQL_COPT_SS_BROWSE_CONNECT

Se ele for definido como SQL_MORE_INFO_YES no SQL Server 2000 e versões posteriores, o SQLBrowseConnect retornará uma cadeia de caracteres estendida de propriedades do servidor.

O exemplo a seguir é de uma cadeia de caracteres estendida retornada por SQLBrowseConnect no SQL Server 2000:

ServerName\InstanceName;Clustered:No;Version:8.00.131

Nessa cadeia de caracteres, ponto-e-vírgulas separam várias partes das informações sobre o servidor. Use vírgulas para separar diferentes instâncias do servidor.

SQL_COPT_SS_BROWSE_SERVER

Se um nome de servidor estiver especificado, o 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.

ObservaçãoObservação
Devido a problemas de rede, o SQLBrowseConnect pode não receber uma resposta oportuna de todos os servidores. Portanto, a lista de servidores retornada 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 estiverem 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 SPNs (Nomes das Entidades 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 como o método de autenticação usado para abrir a conexão.

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

Consulte também

Conceitos

Outros recursos