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:
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çã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).
Histórico de alterações
Conteúdo atualizado |
---|
SQL_COPT_SS_BROWSE_CACHE_DATA documentado. |
Consulte também