Freigeben über

SQLRemoveDriverManager-Funktion

  • Artikel

Konformität
Version eingeführt: ODBC 3.0: In Windows XP Service Pack 2, Windows Server 2003 Service Pack 1 und höheren Betriebssystemen veraltet.

Zusammenfassung
SQLRemoveDriverManager ändert oder entfernt Informationen zu den ODBC-Kernkomponenten aus dem Odbcinst.ini Eintrag in den Systeminformationen.

Syntax

  
BOOL SQLRemoveDriverManager(  
     LPDWORD     pdwUsageCount);

Argumente

pdwUsageCount
[Ausgabe] Die Nutzungsanzahl des Treiber-Managers, nachdem diese Funktion aufgerufen wurde.

Gibt zurück

Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist, FALSE, wenn sie fehlschlägt. Wenn beim Aufruf dieser Funktion kein Eintrag in den Systeminformationen vorhanden ist, gibt die Funktion FALSE zurück.

Diagnose

Wenn SQLRemoveDriverManager FALSE zurückgibt, kann ein zugeordneter *pfErrorCode-Wert abgerufen werden, indem SQLInstallerError aufgerufen wird. In der folgenden Tabelle sind die *pfErrorCode-Werte aufgeführt, die von SQLInstallerError zurückgegeben werden können, und die einzelnen Werte im Kontext dieser Funktion werden erläutert.

*pfErrorCode Fehler BESCHREIBUNG
ODBC_ERROR_GENERAL_ERR Allgemeiner Installationsfehler Es ist ein Fehler aufgetreten, für den kein spezifischer Installerfehler aufgetreten ist.
ODBC_ERROR_COMPONENT_NOT_FOUND Komponente nicht in der Registrierung gefunden Das Installationsprogramm konnte die Treiber-Manager-Informationen nicht entfernen, da sie entweder nicht in der Registrierung vorhanden waren oder nicht in der Registrierung gefunden werden konnten.
ODBC_ERROR_USAGE_UPDATE_FAILED Die Anzahl der Komponentennutzung konnte nicht erhöht oder verringert werden. Das Installationsprogramm konnte die Nutzungsanzahl des Treiber-Managers nicht erhöhen.
ODBC_ERROR_OUT_OF_MEM Nicht genügend Arbeitsspeicher. Das Installationsprogramm konnte die Funktion aufgrund eines Mangels an Arbeitsspeicher nicht ausführen.

Kommentare

SQLRemoveDriverManager ergänzt die FUNKTION SQLInstallDriverManager und aktualisiert die Anzahl der Komponentennutzung in den Systeminformationen. Diese Funktion sollte nur von einer Setupanwendung aufgerufen werden.

SQLRemoveDriverManager verringert die Anzahl der Kernkomponentennutzung um 1. Wenn die Anzahl der Komponentennutzung auf 0 lautet, werden die Eingabesysteminformationen entfernt. Der Kernkomponenteneintrag befindet sich unter dem Titel "ODBC Core" in den Systeminformationen am folgenden Speicherort:

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

Achtung

Eine Anwendung sollte Treiber-Manager-Dateien nicht physisch entfernen, wenn die Anzahl der Komponentennutzung und die Anzahl der Dateinutzung 0 erreichen.

SQLRemoveDriverManager entfernt eigentlich keine Dateien. Das aufrufende Programm ist für das Löschen von Dateien und die Beibehaltung der Anzahl der Dateinutzungen verantwortlich. Treiber-Manager-Dateien sollten jedoch nicht entfernt werden, wenn sowohl die Anzahl der Komponentennutzung als auch die Dateinutzungsanzahl 0 erreicht haben, da diese Dateien möglicherweise von anderen Anwendungen verwendet werden, die die Anzahl der Dateinutzungen nicht erhöht haben.

SQLRemoveDriverManager wird im Rahmen des Deinstallationsprozesses aufgerufen. ODBC-Kernkomponenten (einschließlich Treiber-Manager, Cursorbibliothek, Installer, Sprachbibliothek, Administrator, Thunking-Dateien usw.) werden als Ganzes deinstalliert. Die folgenden Dateien werden nicht entfernt, wenn SQLRemoveDriverManager im Rahmen des Deinstallationsprozesses aufgerufen wird:

ODBC32DLL
ODBCCR32.DLL
ODBCCU32.DLL
ODBCINT.DLL
ODBCTRAC.DLL
MSVCRT40.DLL
ODBCCP32.CPL

ODBCCP32.DLL
ODBC16GT.DLL
ODBC32GT.DLL
DS16GT.DLL
DS32GT.DLL
ODBCAD32.EXE

SQLRemoveDriverManager wird auch als Teil eines Upgradeprozesses aufgerufen. Wenn eine Anwendung erkennt, dass sie ein Upgrade durchführen muss und den Treiber zuvor installiert hat, sollte der Treiber entfernt und dann erneut installiert werden.

SQLRemoveDriverManager sollte zuerst aufgerufen werden, um die Anzahl der Komponentennutzung zu verringern. SQLInstallDriverEx sollte dann aufgerufen werden, um die Anzahl der Komponentennutzung zu erhöhen. Das Anwendungsprogramm muss die alten Kernkomponentendateien durch die neuen Dateien ersetzen. Die Anzahl der Dateiverwendungen bleibt unverändert, und andere Anwendungen, die die Komponentendateien der älteren Version verwenden, verwenden jetzt die Dateien der neueren Version.

Informationen über Finden Sie unter
Installieren eines Treiber-Managers SQLInstallDriverManager