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.