Partage via


SQLRemoveDSNFromIni, fonction

Conformité
Version introduite : ODBC 1.0

Résumé
SQLRemoveDSNFromIni supprime une source de données des informations système.

Syntaxe

  
BOOL SQLRemoveDSNFromIni(  
     LPCSTR   lpszDSN);  

Arguments

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

Retours

La fonction retourne TRUE si elle supprime la source de données ou si la source de données ne se trouvait pas dans le fichier Odbc.ini. Il retourne FALSE si la source de données ne parvient pas à supprimer.

Diagnostics

Lorsque SQLRemoveDSNFromIni retourne FALSE, une valeur *pfErrorCode associée peut être obtenue en appelant SQLInstallerError. 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_INVALID_DSN DSN non valide L’argument lpszDSN n’était pas valide.
ODBC_ERROR_REQUEST_FAILED Échec de la demande Le programme d’installation n’a pas pu supprimer les informations DSN du Registre.
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

SQLRemoveDSNFromIni supprime le nom de la source de données de la section [Sources de données ODBC] des informations système. Il supprime également la section spécification de la source de données des informations système.

Cette fonction doit être appelée uniquement à partir d’une bibliothèque de configuration de pilote.

Pour obtenir des informations sur Consultez
Ajout, modification ou suppression d’une source de données ConfigDSN
Ajout, modification ou suppression d’une source de données SQLConfigDataSource
Suppression de la source de données par défaut SQLRemoveDefaultDataSource
Ajout d’un nom de source de données aux informations système SQLWriteDSNToIni