SQLBrowseConnect
Aplica-se a: 
SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)
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/D | 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. |
| DRIVER | N/D | Não | O nome do driver ODBC do 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 | No | O nome do servidor na rede onde a fonte de dados reside. O termo "(local)" pode ser inserido como o servidor, caso em que uma cópia local do SQL Server pode ser usada, mesmo quando esta é uma versão não conectada em 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 | 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 | Nome do banco de dados SQL Server. |
| LANGUAGE | Sim | Sim | Idioma nacional usado pelo SQL Server. |
O SQLBrowseConnect ignora os valores das palavras-chave DATABASE e LANGUAGE armazenadas nas definições de fonte de dados ODBC. Se o banco de dados ou o 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:No;Version:8.00.131Nessa 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 for 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. Observe que, 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 de SQLBrowseConnect a alta disponibilidade e 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 Suporte ao SQL Server Native Client para alta disponibilidade, 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 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. |
Confira também
Função SQLBrowseConnect
Detalhes da implementação da API do ODBC