Driver-Specific Informações de Conexão

O SQLConnect assume que um nome da fonte de dados, ID de utilizador e palavra-passe são suficientes para se ligar a uma fonte de dados e que toda a outra informação de ligação pode ser armazenada no sistema. Isto muitas vezes não acontece. Por exemplo, um driver pode precisar de um ID de utilizador e palavra-passe para iniciar sessão num servidor e de um ID de utilizador e palavra-passe diferentes para aceder a um SGBD. Como o SQLConnect aceita um único ID de utilizador e palavra-passe, isto significa que o outro ID de utilizador e palavra-passe devem ser armazenados com a informação da fonte de dados no sistema para que o SQLConnect seja utilizado. Isto é uma potencial violação de segurança e deve ser evitado a menos que a palavra-passe esteja encriptada.

O SQLDriverConnect permite ao driver definir uma quantidade arbitrária de informações de conexão nos pares de palavra-chave-valor da string de conexão. Por exemplo, suponha que um driver necessita de um nome de fonte de dados, um ID de utilizador e palavra-passe para o servidor, e um ID de utilizador e palavra-passe para o Sistema de Gestão de Bases de Dados. Um programa personalizado que utilize sempre a fonte de dados da XYZ Corp pode pedir ao utilizador IDs e palavras-passe e construir o seguinte conjunto de pares-palavra-chave, ou cadeia de ligação, para passar ao SQLDriverConnect:

Observação

Se estiver a ligar-se a um fornecedor de fonte de dados que suporta autenticação Windows, deve especificar Trusted_Connection=yes em vez de informações de ID de utilizador e palavra-passe na cadeia de ligação.

DSN={MyDataSourceName};UID={MyUserID};PWD={MyServerPassword};UIDDBMS={MyDBMSUserID};PWDDBMS={MyDBMSUserPassword};  

A palavra-chave DSN (Data Source Name) dá nome à fonte de dados, as palavras-chave UID e PWD especificam o ID de utilizador e a palavra-passe do servidor, e as palavras-chave UIDDBMS e PWDDBMS especificam o ID de utilizador e a palavra-passe do SGBD. Note que o ponto e vírgula final é opcional. O SQLDriverConnect analisa esta cadeia; utiliza o nome da fonte de dados da XYZ Corp para obter informações adicionais de ligação do sistema, como o endereço do servidor; e inicia sessão no servidor e no SGBD usando os IDs de utilizador e palavras-passe especificados.

Pares de palavra-chave/valor em SQLDriverConnect devem seguir certas regras de sintaxe. As palavras-chave e os seus valores não devem conter os []{}(),;?*=!@ caracteres. O valor da palavra-chave DSN não pode consistir apenas em espaços e não deve conter espaços iniciais. Devido à gramática do registo, palavras-chave e nomes de fontes de dados não podem conter o carácter de barra inversa (\). Não são permitidos espaços em torno do sinal igual no par chave-valor.

A palavra-chave FILEDSN pode ser usada numa chamada ao SQLDriverConnect para especificar o nome de um ficheiro que contém informação de fonte de dados (ver Connecting Using File Data Sources, mais adiante nesta secção). A palavra-chave SAVEFILE pode ser usada para especificar o nome de um ficheiro .dsn no qual os pares palavra-chave de uma ligação bem-sucedida feita pela chamada ao SQLDriverConnect serão guardados. Para mais informações sobre fontes de dados de ficheiros, consulte a descrição da função SQLDriverConnect .