Conectando-se com SQLBrowseConnect

O SQLBrowseConnect, tal como o SQLDriverConnect, usa uma cadeia de ligação. No entanto, ao usar SQLBrowseConnect, uma aplicação pode construir uma cadeia de ligação completa em tempo de execução. Isto permite que a aplicação faça duas funções:

• Crie as suas próprias caixas de diálogo para pedir esta informação, mantendo assim o controlo sobre o seu "aspeto e sensação".

• Navegue pelo sistema à procura de fontes de dados que possam ser usadas por um determinado condutor, possivelmente em vários passos. Por exemplo, o utilizador pode primeiro navegar na rede à procura de servidores e, depois de escolher um servidor, navegar pelo servidor à procura de bases de dados acessíveis pelo driver.

A aplicação chama SQLBrowseConnect e passa uma cadeia de ligação, conhecida como cadeia de ligação por pedido de navegação, que especifica um driver ou fonte de dados. O driver devolve uma cadeia de ligação, conhecida como cadeia de ligação do 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 de usar. A aplicação constrói uma caixa de diálogo com os nomes amigáveis de usar e pede valores ao utilizador. Depois, constrói uma nova cadeia de ligação de pedidos de navegação a partir destes valores e devolve-a ao driver com outra chamada para SQLBrowseConnect.

Como as cadeias de ligação são passadas de um lado para o outro, o driver pode fornecer vários níveis de navegação ao devolver uma nova cadeia de ligação quando a aplicação devolve a antiga. Por exemplo, na primeira vez que uma aplicação chama SQLBrowseConnect, o driver pode devolver palavras-chave para pedir ao utilizador o nome do servidor. Quando a aplicação devolve o nome do servidor, o driver pode enviar palavras-chave para pedir ao utilizador uma base de dados. O processo de navegação seria concluído após a aplicação devolver o nome da base de dados.

Cada vez que o SQLBrowseConnect devolve uma nova cadeia de ligação de resultados de navegação, devolve SQL_NEED_DATA como código de retorno. Isto indica à aplicação que o processo de ligação não está completo. Até que o SQLBrowseConnect devolva SQL_SUCCESS, a ligação está num estado de Necessidade de Dados e não pode ser usada para outros fins, como definir um atributo de ligação. A aplicação pode terminar o processo de navegação de ligações chamando SQLDisconnect.

Esta secção contém o seguinte tópico.

• Exemplo de Navegação SQL Server