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/A |
Não |
O nome do driver ODBC do Microsoft® SQL Server Native Client é {SQL Server Native Client 11}. 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, 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: 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.
|
||
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. |
.gif "Observação")
ObservaçãoSuporte de SQLBrowseConnect a alta disponibilidade e recuperação de desastre
Para obter mais informações sobre como usar SQLBrowseConnect para se conectar a um cluster Grupos de Disponibilidade AlwaysOn, consulte Suporte do SQL Server Native Client à alta disponibilidade e recuperação de desastre.
Suporte de SQLBrowseConnect a 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 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
Detalhes de implementação da API ODBC
Outros recursos
Histórico de alterações
Conteúdo atualizado |
|---|
SQL_COPT_SS_BROWSE_CACHE_DATA documentado. |