Solicitando ao usuário informações de conexão

Se o aplicativo usa SQLConnect e precisa solicitar ao usuário qualquer informação de conexão, como um nome de usuário e uma senha, ele deve fazê-lo sozinho. Embora isso permita que o aplicativo controle sua "aparência", ele pode forçar o aplicativo a conter código específico do driver. Isso ocorre quando o aplicativo precisa solicitar ao usuário informações de conexão específicas do driver. Isso apresenta uma situação impossível para aplicativos genéricos, que são projetados para funcionar com todos os drivers, incluindo drivers que não existem quando o aplicativo é gravado.

O SQLDriverConnect pode solicitar ao usuário informações de conexão. Por exemplo, o programa personalizado mencionado anteriormente pode passar a seguinte cadeia de conexão para SQLDriverConnect:

DSN=XYZ Corp;  

Em seguida, o driver pode exibir uma caixa de diálogo que solicita IDs de usuário e senhas, semelhante à ilustração a seguir.

Que o driver pode solicitar informações de conexão é particularmente útil para aplicativos genéricos e verticais. Esses aplicativos não devem conter informações específicas do driver e fazer com que o driver solicite as informações necessárias mantém essas informações fora do aplicativo. Isso é mostrado pelos dois exemplos anteriores. Quando o aplicativo passou apenas o nome da fonte de dados para o driver, o aplicativo não continha nenhuma informação específica do driver e, portanto, não estava vinculado a um driver específico. Quando o aplicativo passou uma cadeia de conexão completa para o driver, ele estava vinculado ao driver que poderia interpretar essa cadeia de caracteres.

Um aplicativo genérico pode levar essa etapa adiante e nem mesmo especificar uma fonte de dados. Quando o SQLDriverConnect recebe uma cadeia de conexão vazia, o Gerenciador de Driver exibe a caixa de diálogo a seguir.

Depois que o usuário seleciona uma fonte de dados, o Gerenciador de Driver constrói uma cadeia de conexão especificando essa fonte de dados e a passa para o driver. Em seguida, o driver pode solicitar ao usuário qualquer informação adicional necessária.

As condições sob as quais o driver solicita ao usuário são controladas pelo sinalizador DriverCompletion; há opções para sempre solicitar, solicitar se necessário ou nunca solicitar. Para obter uma descrição completa desse sinalizador, consulte a descrição da função SQLDriverConnect .