Conectando-se ao SQLBrowseConnect

SQLBrowseConnect, como SQLDriverConnect, usa uma cadeia de conexão. No entanto, usando SQLBrowseConnect, um aplicativo pode construir uma cadeia de conexão completa em tempo de execução. Isso permite que o aplicativo faça duas coisas:

• Crie suas próprias caixas de diálogo para solicitar essas informações, mantendo assim o controle sobre sua "aparência".

• Navegue pelo sistema em busca de fontes de dados que possam ser usadas por um driver específico, possivelmente em várias etapas. Por exemplo, o usuário pode primeiro procurar servidores na rede e, depois de escolher um servidor, procurar o servidor para bancos de dados acessíveis pelo driver.

O aplicativo chama SQLBrowseConnect e passa uma cadeia de conexão, conhecida como cadeia de conexão de solicitação de navegação, que especifica um driver ou uma fonte de dados. O driver retorna uma cadeia de conexão, conhecida como a cadeia de conexão de resultado de navegação, que contém palavras-chave, valores possíveis (se a palavra-chave aceitar um conjunto discreto de valores) e nomes amigáveis ao usuário. O aplicativo cria uma caixa de diálogo com os nomes amigáveis do usuário e solicita valores ao usuário. Em seguida, ele cria uma nova cadeia de conexão de solicitação de navegação a partir desses valores e retorna isso para o driver com outra chamada para SQLBrowseConnect.

Como as cadeias de conexão são passadas para frente e para trás, o driver pode fornecer vários níveis de navegação retornando uma nova cadeia de conexão quando o aplicativo retorna a antiga. Por exemplo, na primeira vez que um aplicativo chama SQLBrowseConnect, o driver pode retornar palavras-chave para solicitar ao usuário um nome de servidor. Quando o aplicativo retorna o nome do servidor, o driver pode retornar palavras-chave para solicitar ao usuário um banco de dados. O processo de navegação seria concluído depois que o aplicativo retornasse o nome do banco de dados.

Sempre que o SQLBrowseConnect retorna uma nova cadeia de conexão de resultado de navegação, ele retorna SQL_NEED_DATA como seu código de retorno. Isso informa ao aplicativo que o processo de conexão não está concluído. Até que o SQLBrowseConnect retorne SQL_SUCCESS, a conexão estará em um estado De Necessidade de Dados e não poderá ser usada para outras finalidades, como definir um atributo de conexão. O aplicativo pode encerrar o processo de navegação de conexão chamando SQLDisconnect.

Esta seção contém o tópico a seguir.

• Exemplo de navegação do SQL Server