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