SQLInstallDriverManager-Funktion
Konformität
Eingeführte Version: ODBC 1.0: Veraltet in Windows XP Service Pack 2, Windows Server 2003 Service Pack 1 und höher
Zusammenfassung
SQLInstallDriverManager gibt den Pfad des Zielverzeichnisses für die Installation der ODBC-Kernkomponenten zurück. Das aufrufende Programm muss tatsächlich die Dateien des Treiber-Managers in das Zielverzeichnis kopieren.
Syntax
BOOL SQLInstallDriverManager(
LPSTR lpszPath,
WORD cbPathMax,
WORD * pcbPathOut);
Argumente
lpszPath
[Ausgabe] Pfad des Zielverzeichnisses der Installation.
cbPathMax
[Eingabe] Länge von lpszPath. Dies muss mindestens _MAX_PATH Bytes sein.
pcbPathOut
[Ausgabe] Gesamtanzahl der bytes (ohne null-terminierungsbyte), die in lpszPath zurückgegeben werden. Wenn die Anzahl der zurückzugebenden Bytes größer oder gleich cbPathMax ist, wird der Pfad in lpszPath zu cbPathMax abgeschnitten, abzüglich des NULL-Terminierungszeichens. Das argument pcbPathOut kann ein NULL-Zeiger sein.
Gibt zurück
Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist, FALSE, wenn sie fehlschlägt.
Diagnose
Wenn SQLInstallDriverManager FALSE zurückgibt, kann durch Aufrufen von SQLInstallerError ein zugeordneter *pfErrorCode-Wert abgerufen werden. In der folgenden Tabelle sind die *pfErrorCode-Werte aufgeführt, die von SQLInstallerError zurückgegeben werden können, und erläutert die einzelnen Werte im Kontext dieser Funktion.
*pfErrorCode | Fehler | BESCHREIBUNG |
---|---|---|
ODBC_ERROR_GENERAL_ERR | Allgemeiner Installationsfehler | Es ist ein Fehler aufgetreten, für den kein spezifischer Installationsfehler aufgetreten ist. |
ODBC_ERROR_INVALID_BUFF_LEN | Ungültige Pufferlänge | Das lpszPath-Argument war nicht groß genug, um den Ausgabepfad zu enthalten. Der Puffer enthält den abgeschnittenen Pfad. Das argument cbPathMax war kleiner als _MAX_PATH. |
ODBC_ERROR_USAGE_UPDATE_FAILED | Die Anzahl der Komponentennutzung konnte nicht erhöht oder verringert werden. | Das Installationsprogramm konnte die Anzahl der ODBC-Kernkomponenten 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
SQLInstallDriverManager wird aufgerufen, um den Pfad für ODBC-Kernkomponenten zurückzugeben und die Anzahl der Komponentennutzung in den Systeminformationen zu erhöhen. Wenn bereits eine Version des Treiber-Managers vorhanden ist, die Komponentennutzungsanzahl für den Treiber jedoch nicht vorhanden ist, wird der neue Wert für die Komponentennutzungsanzahl auf 2 festgelegt.
Das Programm zur Anwendungseinrichtung ist für das physische Kopieren der Kernkomponentendateien und die Verwaltung der Anzahl der Dateinutzungen verantwortlich. Wenn noch keine Kernkomponentendatei installiert wurde, muss das Programm für das Anwendungssetup die Datei kopieren und die Anzahl der Dateinutzungen erstellen. Wenn die Datei zuvor installiert wurde, erhöht das Setupprogramm lediglich die Anzahl der Dateinutzungen.
Wenn zuvor eine ältere Version des Treiber-Managers vom Programm für das Setup der Anwendung installiert wurde, sollten die Kernkomponenten deinstalliert und dann neu installiert werden, damit die Anzahl der Kernkomponenten gültig ist. SQLRemoveDriverManager sollte zuerst aufgerufen werden, um die Anzahl der Komponentennutzungen zu verringern. SQLInstallDriverManager sollte dann aufgerufen werden, um die Anzahl der Komponentennutzungen zu erhöhen. Das Anwendungsprogramm muss die alten Kernkomponentendateien durch die neuen Dateien ersetzen. Die Anzahl der Dateinutzungen bleibt unverändert, und andere Anwendungen, die die älteren Versionskernkomponentendateien verwendet haben, verwenden jetzt die neueren Versionsdateien.
Bei einer Neuinstallation der ODBC-Kernkomponenten, -Treiber und -Übersetzer sollte das Programm für die Anwendungseinrichtung die folgenden Funktionen nacheinander aufrufen: SQLInstallDriverManager, SQLInstallDriverEx, SQLConfigDriver (mit einer fRequest von ODBC_INSTALL_DRIVER) und anschließend SQLInstallTranslatorEx. Bei einer Deinstallation der Kernkomponenten, Treiber und Übersetzer sollte das Programm für die Anwendungseinrichtung die folgenden Funktionen nacheinander aufrufen: SQLRemoveTranslator, SQLRemoveDriver und anschließend SQLRemoveDriverManager. Diese Funktionen müssen in dieser Sequenz aufgerufen werden. Bei einem Upgrade aller Komponenten sollten alle Deinstallationsfunktionen nacheinander aufgerufen werden, und dann sollten alle Installationsfunktionen nacheinander aufgerufen werden.
Verwandte Funktionen
Informationen über | Finden Sie unter |
---|---|
Hinzufügen, Ändern oder Entfernen eines Treibers | SQLConfigDriver |
Installieren eines Treibers | SQLInstallDriverEx |
Installieren eines Übersetzers | SQLInstallTranslatorEx |
Entfernen eines Treibers | SQLRemoveDriver |
Entfernen des Treiber-Managers | SQLRemoveDriverManager |
Entfernen eines Übersetzers | SQLRemoveTranslator |