Partager via

SQLValidDSN, fonction

  • Article

Conformité
Version introduite : ODBC 2.0

Résumé
SQLValidDSN vérifie la longueur et la validité du nom de la source de données avant d’ajouter le nom aux informations système.

Syntaxe

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);

Arguments

lpszDSN
[Entrée] Nom de la source de données à vérifier.

Retours

La fonction retourne TRUE si le nom de la source de données est valide. Elle retourne FALSE si le nom de la source de données n’est pas valide ou si l’appel de fonction a échoué.

Diagnostics

Lorsque SQLValidDSN retourne FALSE, une valeur *pfErrorCode associée peut être obtenue en appelant SQLInstallerError. Un *pfErrorCode est retourné uniquement si l’appel de fonction a échoué, et non si FALSE a été retourné, car le nom de la source de données n’est pas valide. Le tableau suivant répertorie les valeurs *pfErrorCode qui peuvent être retournées par SQLInstallerError et explique chacune d’elles dans le contexte de cette fonction.

*pfErrorCode Error Description
ODBC_ERROR_GENERAL_ERR Erreur générale du programme d’installation Une erreur s’est produite pour laquelle il n’y a pas eu d’erreur de programme d’installation spécifique.
ODBC_ERROR_OUT_OF_MEM Mémoire insuffisante Le programme d’installation n’a pas pu exécuter la fonction en raison d’un manque de mémoire.

Commentaires

SQLValidDSN est appelé par le configDSN d’un pilote pour vérifier la longueur du nom de la source de données et la validité des caractères individuels dans le nom de la source de données. Il vérifie si la longueur du nom est supérieure à SQL_MAX_DSN_LENGTH, comme défini dans Sqlext.h. (La longueur du nom de la source de données est également vérifiée par SQLWriteDSNToIni.) SQLValidDSN vérifie si l’un des caractères non valides suivants est inclus dans le nom de la source de données :

[ ] { } ( ) , ; ? * = ! @ \

Pour obtenir des informations sur Consultez
Ajout, modification ou suppression d’une source de données ConfigDSN (dans la DLL d’installation)
Ajout, modification ou suppression d’une source de données SQLConfigDataSource
Écriture d’un nom de source de données dans les informations système SQLWriteDSNToIni