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 | 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 | Microsoft?? SQL Server Native Client nome do driver ODBC é {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 de SQL Server pode ser usada, mesmo quando esta é uma versão não 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 por 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; Clusterizado:Não; Versão: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 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 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 Always On, consulte suporte SQL Server Native Client para alta disponibilidade e recuperação de desastres.
Suporte de SQLBrowseConnect a SPNs (nomes de entidade de serviço)
Quando uma conexão é aberta, 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 Conexões de Cliente (ODBC).
Histórico de alterações
| Conteúdo atualizado |
|---|
| SQL_COPT_SS_BROWSE_CACHE_DATA documentado. |