Datenbankfunktionen
Diese Materialien richten sich an Entwickler*innen, die ihre eigenen Setupprogramme schreiben und Entwickler*innen, die mehr über Installer-Datenbanktabellen erfahren möchten. Allgemeine Informationen zum Installationsprogramm finden Sie unter Informationen zu Windows Installer.
Sie können die Zugriffsfunktionen des Installers verwenden, um auf die Datenbank und den Installationsprozess zuzugreifen. Diese Funktionen sollten nur von benutzerdefinierten Installationsaktionen und Entwicklungstools verwendet werden. Einige der Zugriffsfunktionen des Installers erfordern SQL-Abfragezeichenfolgen für die Abfrage der Datenbank. Abfragen müssen der SQL-Syntax des Installers entsprechen.
In diesem Thema werden die Datenbankzugriffsfunktionen des Installers nach Kategorie aufgelistet.
Allgemeine Datenbankzugriffsfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiDatabaseCommit | Committet Änderungen an einer Datenbank. |
| MsiDatabaseGetPrimaryKeys | Gibt die Namen aller Primärschlüsselspalten zurück. |
| MsiDatabaseIsTablePersistent | Gibt eine Enumeration zurück, die den Zustand einer Tabelle beschreibt. |
| MsiDatabaseOpenView | Bereitet eine Datenbankabfrage vor und erstellt ein Ansichtsobjekt. |
| MsiGetActiveDatabase | Gibt die aktive Datenbank für die Installation zurück. |
| MsiViewGetColumnInfo | Gibt Spaltennamen oder -definitionen zurück. |
| MsiOpenDatabase | Öffnet eine Datenbankdatei für den Datenzugriff. |
| MsiViewClose | Gibt das Resultset für eine ausgeführte Ansicht frei. |
| MsiViewExecute | Führt die Ansichtsabfrage aus und stellt die erforderlichen Parameter bereit. |
| MsiViewFetch | Ruft den nächsten sequenziellen Datensatz aus der Ansicht ab. |
| MsiViewGetError | Gibt den Fehler zurück, der in der MsiViewModify-Funktion aufgetreten ist. |
| MsiViewModify | Updatet einen abgerufenen Datensatz. |
Datenbankverwaltungsfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiCreateTransformSummaryInfo | Erstellt Zusammenfassungsinformationen für eine vorhandene Transformation. |
| MsiDatabaseApplyTransform | Wendet eine Transformation auf eine Datenbank an. |
| MsiDatabaseExport | Exportiert eine Tabelle aus einer geöffneten Datenbank in eine Textarchivdatei. |
| MsiDatabaseGenerateTransform | Generiert eine Transformationsdatei mit Unterschieden zwischen zwei Datenbanken. |
| MsiDatabaseImport | Importiert eine Textarchivtabelle des Installers in eine geöffnete Datenbank. |
| MsiDatabaseMerge | Führt zwei Datenbanken zusammen. |
| MsiGetDatabaseState | Gibt den Status der Datenbank zurück. |
Datensatzverarbeitungsfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiCreateRecord | Erstellt ein neues Datensatzobjekt mit der angegebenen Anzahl von Feldern. |
| MsiFormatRecord | Formatiert Datensatzfelddaten und -eigenschaften mithilfe einer Formatzeichenfolge. |
| MsiRecordClearData | Legt alle Felder in einem Datensatz auf NULL fest. |
| MsiRecordDataSize | Gibt die Länge eines Datensatzfelds zurück. |
| MsiRecordGetFieldCount | Gibt die Anzahl von Feldern in einem Datensatz zurück |
| MsiRecordGetInteger | Gibt den ganzzahligen Wert aus einem Datensatzfeld zurück. |
| MsiRecordGetString | Gibt den Zeichenfolgenwert eines Datensatzfelds zurück. |
| MsiRecordIsNull | Gibt an, ob ein Datensatzfeld NULL ist. |
| MsiRecordReadStream | Liest Bytes aus einem Datensatzdatenstromfeld in einen Puffer. |
| MsiRecordSetInteger | Legt ein Datensatzfeld auf ein ganzzahliges Feld fest. |
| MsiRecordSetStream | Legt ein Datensatzdatenstromfeld aus einer Datei fest. |
| MsiRecordSetString | Kopiert eine Zeichenfolge in das angegebene Feld. |
Eigenschaftenfunktionen für Zusammenfassungsinformationen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiGetSummaryInformation | Erhält den Zugriff auf den Zusammenfassungsinformations-Datenstrom der Installer-Datenbank. |
| MsiSummaryInfoGetProperty | Ruft eine einzelne Eigenschaft aus den Zusammenfassungsinformationen ab. |
| MsiSummaryInfoGetPropertyCount | Gibt die Anzahl der Eigenschaften im Zusammenfassungsinformations-Datenstrom zurück. |
| MsiSummaryInfoPersist | Schreibt geänderte Zusammenfassungsinformationen zurück in den Zusammenfassungsinformations-Datenstrom. |
| MsiSummaryInfoSetProperty | Legt eine einzelne Zusammenfassungsinformationseigenschaft fest. |
Installerstatuszugriffsfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiGetLanguage | Gibt die numerische Sprache der aktuellen Installation zurück. |
| MsiGetLastErrorRecord | Gibt den Fehlerdatensatz zurück, der zuletzt für den aufrufenden Prozess zurückgegeben wurde. |
| MsiGetMode | Gibt einen der booleschen internen Installationsstatus zurück. |
| MsiGetProperty | Ruft den Wert einer Installereigenschaft ab. |
| MsiSetProperty | Legt den Wert einer Installationseigenschaft fest. |
| MsiSetMode | Legt einen booleschen Status der internen Engine fest. |
Installationsaktionsfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiDoAction | Führt eine integrierte Aktion, eine benutzerdefinierte Aktion oder eine Benutzeroberflächen-Assistentaktion aus. |
| MsiEvaluateCondition | Wertet einen bedingten Ausdruck aus, der Eigenschaftsnamen und -werte enthält. |
| MsiProcessMessage | Sendet einen Fehlerdatensatz zur Verarbeitung an das Installationsprogramm. |
| MsiSequence | Führt eine Aktionssequenz aus. |
Installerspeicherortfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiGetSourcePath | Gibt den vollständigen Quellpfad für einen Ordner in der Verzeichnistabelle zurück. |
| MsiGetTargetPath | Gibt den vollständigen Zielpfad für einen Ordner in der Verzeichnistabelle zurück. |
| MsiSetTargetPath | Legt den vollständigen Zielpfad für einen Ordner in der Verzeichnistabelle fest. |
Installerauswahlfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiEnumComponentCosts | Listet den Speicherplatz pro Laufwerk auf, der für die Installation einer Komponente erforderlich ist. |
| MsiGetComponentState | Ruft den Zustand einer Komponente ab. |
| MsiGetFeatureCost | Gibt den für eine Funktion erforderlichen Speicherplatz zurück. |
| MsiGetFeatureState | Ruft den Status einer Funktion ab. |
| MsiGetFeatureValidStates | Gibt einen gültigen Installationsstatus zurück. |
| MsiSetComponentState | Legt eine Komponente auf den angegebenen Zustand fest. |
| MsiSetFeatureAttributes | Ändert die Standardattribute einer Funktion zur Laufzeit. |
| MsiSetFeatureState | Legt eine Funktion auf einen angegebenen Status fest. |
| MsiSetInstallLevel | Legt die Installationsebene einer vollständigen Produktinstallation fest. |
| MsiVerifyDiskSpace | Überprüft, ob genügend Speicherplatz auf dem Datenträger vorhanden ist. |
Benutzeroberflächenfunktionen
| Funktion | BESCHREIBUNG |
|---|---|
| MsiEnableUIPreview | Aktiviert den Vorschaumodus der Benutzeroberfläche. |
| MsiPreviewBillboard | Zeigt ein Billboard mit der Hoststeuerung im angezeigten Dialogfeld an. |
| MsiPreviewDialog | Zeigt ein Dialogfeld als moduslos und inaktiv an. |
Alle Funktionen unterstützen sowohl ANSI- als auch Unicode-Aufrufe. Um diese Funktionen zu verwenden, schließen Sie MsiQuery.h ein, und verknüpfen Sie sie mit Msi.lib.
Installationsfunktionen
Zusätzlich zu den oben aufgeführten Datenbankzugriffsfunktionen erstellen Sie ein Installationspaket für eine Anwendung, indem Sie die im Abschnitt Referenz zur Installerfunktion aufgeführten Installerfunktionen verwenden.