Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
Gilt für:
SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-Instanz
Die Installer DLL-API bietet Funktionen für die programmgesteuerte Verwaltung von ODBC-Datenquellen, Treibern und Übersetzern. Anwendungen und Setupprogramme verwenden diese Funktionen zum Installieren, Konfigurieren und Entfernen von ODBC-Komponenten und zum Verwalten von Registrierungsinformationen. Microsoft schreibt und verteilt die Installer-DLL.
Die API besteht aus 25 Funktionen. Drei dieser Funktionen, SQLGetTranslator, SQLRemoveDSNFromIniund SQLWriteDSNToIni, werden nur von Setup-DLLs aufgerufen. Setup- und Verwaltungsprogramme rufen die anderen Funktionen auf.
Jede Funktion wird mit der Version von ODBC bezeichnet, in der sie eingeführt wurde.
Datenquellenkonfiguration
Diese Funktionen erstellen, ändern und entfernen ODBC-Datenquellen programmgesteuert. Verwenden Sie sie beim Erstellen von benutzerdefinierten Setupprogrammen oder Anwendungen, die Datenquellenverbindungen ohne Benutzerinteraktion konfigurieren müssen.
| Funktion | Description |
|---|---|
| SQLConfigDataSource | Fügt eine Datenquelle hinzu, ändert oder löscht sie. Ruft die Treibersetup-DLL auf, um die tatsächliche Konfiguration auszuführen. |
| SQLCreateDataSource | Zeigt ein Dialogfeld an, in dem Benutzer interaktiv eine Datenquelle hinzufügen können. |
| SQLManageDataSources | Zeigt ein Dialogfeld zum Verwalten von Datenquellen und Ablaufverfolgungsoptionen an, ähnlich dem ODBC-Datenquellenadministrator. |
| SQLValidDSN | Überprüft die Länge und Gültigkeit eines Datenquellennamens, bevor er in die Registrierung geschrieben wird. |
| SQLReadFileDSN | Liest Verbindungsinformationen aus einem dateibasierten Datenquellennamen (DSN-Datei). |
| SQLWriteFileDSN | Schreibt Verbindungsinformationen in einen dateibasierten Datenquellennamen (DSN-Datei). |
| SQLRemoveDefaultDataSource | Entfernt die Standarddatenquelle aus den Systeminformationen. |
Treiberinstallation und -entfernung
Diese Funktionen installieren und entfernen ODBC-Treiber aus dem System. Sie verwalten Registrierungseinträge und Nutzungsanzahlen, um mehrere Anwendungen zu unterstützen, die dieselben Treiber verwenden.
| Funktion | Description |
|---|---|
| SQLInstallDriverEx | Fügt der Registrierung Treiberinformationen hinzu und erhöht die Anzahl der Treibernutzung. Gibt das Zielverzeichnis für Treiberdateien zurück. |
| SQLInstallDriverManager | Gibt das Zielverzeichnis für die Installation von ODBC-Kernkomponenten zurück. Veraltet in ODBC 3.0, da der Treiber-Manager Teil von Windows ist. |
| SQLRemoveDriver | Entfernt Treiberinformationen aus der Registrierung. Erhöht die Nutzungsanzahl des Treibers und entfernt Registrierungseinträge, wenn die Anzahl null erreicht. |
| SQLRemoveDriverManager | Erhöht die Anzahl der ODBC-Kernkomponentennutzung. Veraltet, da der Treiber-Manager jetzt Teil von Windows ist. |
| SQLConfigDriver | Lädt die Setup-DLL eines Treibers und ruft seine ConfigDriver Funktion auf, um treiberspezifische Konfigurationsaufgaben auszuführen. |
Installation und Entfernung von Übersetzern
Diese Funktionen verwalten ODBC-Übersetzer, die Daten zwischen Zeichensätzen konvertieren (z. B. ANSI in Unicode). Verwenden Sie diese, wenn Ihre Anwendung während der Kommunikation mit einer Datenquelle Eine Datenübersetzung erfordert.
| Funktion | Description |
|---|---|
| SQLInstallTranslatorEx | Fügt der Registrierung Übersetzerinformationen hinzu und erhöht die Anzahl der Übersetzerverwendungen. |
| SQLInstallTranslator | Installiert einen Übersetzer. Veraltet; verwenden Sie SQLInstallTranslatorEx stattdessen. |
| SQLRemoveTranslator | Entfernt Übersetzerinformationen aus der Registrierung. Erhöht die Verwendungsanzahl und entfernt Einträge, wenn die Anzahl null erreicht. |
| SQLGetTranslator | Zeigt ein Dialogfeld zum Auswählen eines Übersetzers an. Wird von Treibersetup-DLLs aufgerufen, um Benutzer zur Auswahl des Übersetzers aufzufordern. |
Registrierungs- und Konfigurationshilfsprogramme
Diese Funktionen lesen und schreiben Konfigurationsdaten im ODBC-Abschnitt der Windows-Registrierung. Andere Installationsfunktionen und Treibersetup-DLLs verwenden sie intern.
| Funktion | Description |
|---|---|
| SQLWriteDSNToIni | Fügt der Registrierung einen Datenquellennamen hinzu. Wird beim Erstellen einer neuen Datenquelle von Treibersetup-DLLs aufgerufen. |
| SQLRemoveDSNFromIni | Entfernt einen Datenquellennamen aus der Registrierung. Aufgerufen von Treibersetup-DLLs beim Löschen einer Datenquelle. |
| SQLGetPrivateProfileString | Liest einen Wert aus einem Unterschlüssel für die Datenquellenspezifikation in der Registrierung. |
| SQLWritePrivateProfileString | Schreibt einen Wert in einen Unterschlüssel für die Datenquellenspezifikation in der Registrierung. |
| SQLGetInstalledDrivers | Gibt eine Liste der installierten ODBC-Treiber aus der Registrierung zurück. |
| SQLGetConfigMode | Ruft den Konfigurationsmodus ab, der angibt, welcher Registrierungsspeicherort (Benutzer oder System) für Datenquelleneinträge verwendet wird. |
| SQLSetConfigMode | Legt den Konfigurationsmodus fest, der angibt, wo Datenquelleneinträge in der Registrierung geschrieben werden. |
Fehlerbehandlung
Diese Funktionen enthalten Fehlerinformationen, wenn Installationsprogrammfunktionen fehlschlagen.
| Funktion | Description |
|---|---|
| SQLInstallerError | Gibt Fehler- oder Statusinformationen für Installationsprogrammfunktionen zurück. Jede Funktion in der Installer-DLL stellt null oder mehr Fehler bereit, die von dieser Funktion abgerufen werden können. |
| SQLPostInstallerError | Ermöglicht Treibersetup-DLLs, Fehler an die Fehlerwarteschlange des Installationsprogramms zu melden, SQLInstallerError sodass sie zurückgegeben werden können. |