SQLRemoveDriverManager, fonction

Conformité
Version introduite : ODBC 3.0 : déconseillée dans Windows XP Service Pack 2, Windows Server 2003 Service Pack 1 et les systèmes d’exploitation ultérieurs.

Résumé
SQLRemoveDriverManager modifie ou supprime des informations sur les composants principaux ODBC de l’entrée Odbcinst.ini dans les informations système.

Syntaxe

  
BOOL SQLRemoveDriverManager(  
     LPDWORD     pdwUsageCount);  

Arguments

pdwUsageCount
[Sortie] Nombre d’utilisation du Gestionnaire de pilotes 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 SQLRemoveDriverManager 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.

Commentaires

SQLRemoveDriverManager complète la fonction SQLInstallDriverManager 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.

SQLRemoveDriverManager décrémente le nombre d’utilisation des composants principaux de 1. Si le nombre d’utilisation des composants passe à 0, les informations du système d’entrée sont supprimées. L’entrée du composant principal se trouve à l’emplacement suivant dans les informations système, sous le titre « ODBC Core » :

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

SQLRemoveDriverManager ne supprime pas réellement les fichiers. Le programme appelant est responsable de la suppression des fichiers et de la maintenance du nombre d’utilisation des fichiers. Toutefois, les fichiers du Gestionnaire de pilotes ne doivent pas être supprimés lorsque le nombre d’utilisation des composants et le nombre d’utilisation des fichiers ont atteint zéro, car ces fichiers peuvent être utilisés par d’autres applications qui n’ont pas incrémenté le nombre d’utilisation des fichiers.

SQLRemoveDriverManager est appelé dans le cadre du processus de désinstallation. Les composants principaux ODBC (qui incluent le Gestionnaire de pilotes, la bibliothèque de curseurs, le programme d’installation, la bibliothèque de langues, l’administrateur, les fichiers thunking, etc.) sont désinstallés dans leur ensemble. Les fichiers suivants ne sont pas supprimés lorsque SQLRemoveDriverManager est appelé dans le cadre du processus de désinstallation :

SQLRemoveDriverManager 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é.

SQLRemoveDriverManager doit d’abord être appelé pour décrémenter le nombre d’utilisation des composants. SQLInstallDriverEx doit ensuite être appelé pour incrémenter le nombre d’utilisation des composants. Le programme d’installation de l’application doit remplacer les anciens fichiers de composants de base par les nouveaux fichiers. Le nombre d’utilisation des fichiers reste le même, et les autres applications qui utilisent les anciens fichiers de composants de base utilisent désormais les fichiers de version plus récents.

Fonctions connexes