SQLRemoveTranslator, fonction

Conformité
Version introduite : ODBC 3.0

Résumé
SQLRemoveTranslator supprime les informations relatives à un traducteur de la section Odbcinst.ini des informations système et décrémente le nombre d’utilisation des composants du traducteur de 1.

Syntaxe

  
BOOL SQLRemoveTranslator(  
     LPCSTR    lpszTranslator,  
     LPDWORD   lpdwUsageCount);  

Arguments

lpszTranslator
[Entrée] Nom du traducteur tel qu’inscrit dans le Odbcinst.ini clé des informations système.

lpdwUsageCount
[Sortie] Nombre d’utilisation du traducteur après l’appel de cette fonction.

Retours

La fonction retourne TRUE si elle réussit, et FALSE si elle échoue. Si aucune entrée n’existe dans les informations système lorsque cette fonction est appelée, la fonction retourne FALSE.

Diagnostics

Lorsque SQLRemoveTranslator 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_COMPONENT_NOT_FOUND	Composant introuvable dans le Registre	Le programme d’installation n’a pas pu supprimer les informations du traducteur, car elles n’existaient pas dans le Registre ou ne se trouvaient pas dans le Registre.
ODBC_ERROR_INVALID_NAME	Nom du pilote ou du traducteur non valide	L’argument lpszTranslator n’était pas valide.
ODBC_ERROR_USAGE_UPDATE_FAILED	Impossible d’incrémenter ou de décrémenter le nombre d’utilisation des composants	Le programme d’installation n’a pas réussi à décrémenter le nombre d’utilisation du pilote.
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

SQLRemoveTranslator complète la fonction SQLInstallTranslatorEx et met à jour le nombre d’utilisation des composants dans les informations système. Cette fonction doit être appelée uniquement à partir d’une application d’installation.

SQLRemoveTranslator décrémente le nombre d’utilisation des composants de 1. Si le nombre d’utilisation des composants passe à 0, l’entrée du traducteur dans les informations système est supprimée. L’entrée du traducteur se trouve à l’emplacement suivant dans les informations système, sous le nom du traducteur :

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

SQLRemoveTranslator ne supprime aucun fichier. Le programme appelant est responsable de la suppression des fichiers et de la maintenance du nombre d’utilisation des fichiers. Un fichier est supprimé physiquement uniquement une fois que le nombre d’utilisation des composants et le nombre d’utilisation des fichiers ont atteint zéro. Certains fichiers d’un composant peuvent être supprimés et d’autres non supprimés, selon que les fichiers sont utilisés ou non par d’autres applications qui ont incrémenté le nombre d’utilisation des fichiers.

SQLRemoveTranslator est également appelé dans le cadre d’un processus de mise à niveau. Si une application détecte qu’elle doit effectuer une mise à niveau et qu’elle a déjà installé le pilote, le pilote doit être supprimé, puis réinstallé. SQLRemoveTranslator doit d’abord être appelé pour décrémenter le nombre d’utilisation des composants, puis SQLInstallTranslatorEx doit être appelé pour incrémenter le nombre d’utilisation des composants. Le programme d’installation de l’application doit remplacer physiquement les anciens fichiers par les nouveaux fichiers. Le nombre d’utilisation des fichiers reste le même, et les autres applications qui utilisent les fichiers de version antérieure utilisent désormais la version la plus récente.

Fonctions connexes

Pour obtenir des informations sur	Consultez
Installation d’un traducteur	SQLInstallTranslatorEx