Datenbankfunktionen

Dieses Material ist für Entwickler gedacht, die eigene Setupprogramme und Entwickler schreiben, die mehr über die Installationsdatenbanktabellen erfahren möchten. Allgemeine Informationen zum Installationsprogramm finden Sie unter "Informationen zu Windows Installer".

Sie können die Installationsprogrammzugriffsfunktionen verwenden, um auf die Datenbank und den Installationsprozess zuzugreifen. Diese Funktionen sollten nur von benutzerdefinierten Installationsaktionen und Erstellungstools verwendet werden. Einige der Installationsprogrammzugriffsfunktionen erfordern SQL Abfragezeichenfolgen zum Abfragen der Datenbank. Abfragen müssen dem Installer SQL Syntax entsprechen.

In diesem Thema werden die Installationsdatenbankzugriffsfunktionen nach Kategorie aufgelistet.

Allgemeine Datenbankzugriffsfunktionen

Funktion Beschreibung
MsiDatabaseCommit Commits von Änderungen an einer Datenbank.
MsiDatabaseGetPrimaryKeys Gibt die Namen aller Primärschlüsselspalten zurück.
MsiDatabaseIsTablePersistent Gibt eine Aufzählung zurück, die den Status 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 den Resultset für eine ausgeführte Ansicht frei.
MsiViewExecute Führt die Ansichtsabfrage aus und stellt erforderliche 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 Aktualisiert 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 Textdatei.
MsiDatabaseGenerateTransform Generiert eine Transformationsdatei mit Unterschieden zwischen zwei Datenbanken.
MsiDatabaseImport Importiert eine Installationstextarchivtabelle 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 Meldet, 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.

 

Funktionen der Zusammenfassungsinformationseigenschaft

Funktion Beschreibung
MsiGetSummaryInformation Ruft die Handle to summary information stream of installer database.
MsiSummaryInfoGetProperty Ruft eine einzelne Eigenschaft aus den Zusammenfassungsinformationen ab.
MsiSummaryInfoGetPropertyCount Gibt die Anzahl der Eigenschaften im Zusammenfassungsinformationsdatenstrom zurück.
MsiSummaryInfoPersist Schreibt geänderte Zusammenfassungsinformationen zurück in den Sammelinformationsdatenstrom.
MsiSummaryInfoSetProperty Legt eine einzelne Zusammenfassungsinformationseigenschaft fest.

 

Installationsprogrammstatuszugriffsfunktionen

Funktion Beschreibung
MsiGetLanguage Gibt die numerische Sprache der aktuellen Installation zurück.
MsiGetLastErrorRecord Gibt den Fehlerdatensatz zurück, der zuletzt für den Aufrufvorgang zurückgegeben wurde.
MsiGetMode Gibt einen der internen Installationszustände vom Typ Boolean zurück.
MsiGetProperty Ruft den Wert einer Installer-Eigenschaft ab.
MsiSetProperty Legt den Wert einer Installationseigenschaft fest.
MsiSetMode Legt einen internen booleschen Zustand fest.

 

Installationsprogrammaktionsfunktionen

Funktion Beschreibung
MsiDoAction Führt integrierte Aktion, benutzerdefinierte Aktion oder Benutzeroberflächen-Assistentenaktion aus.
MsiEvaluateCondition Wertet einen bedingten Ausdruck aus, der Eigenschaftsnamen und -werte enthält.
MsiProcessMessage Sendet einen Fehlerdatensatz an das Installationsprogramm zur Verarbeitung.
MsiSequence Führt eine Aktionssequenz aus.

 

Installationsortfunktionen

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.

 

Installationsprogrammauswahlfunktionen

Funktion Beschreibung
MsiEnumComponentCosts Aufzählt den Speicherplatz pro Laufwerk, der zum Installieren einer Komponente erforderlich ist.
MsiGetComponentState Ruft den Status einer Komponente ab.
MsiGetFeatureCost Gibt den für ein Feature erforderlichen Speicherplatz zurück.
MsiGetFeatureState Ruft den Status eines Features ab.
MsiGetFeatureValidStates Gibt einen gültigen Installationszustand zurück.
MsiSetComponentState Legt eine Komponente auf den angegebenen Zustand fest.
MsiSetFeatureAttributes Ändert die Standardattribute eines Features zur Laufzeit.
MsiSetFeatureState Legt ein Feature auf einen angegebenen Zustand fest.
MsiSetInstallLevel Legt die Installationsebene einer vollständigen Produktinstallation fest.
MsiVerifyDiskSpace Sucht nach ausreichendem Speicherplatz.

 

Benutzeroberflächenfunktionen

Funktion Beschreibung
MsiEnableUIPreview Aktiviert den Vorschaumodus der Benutzeroberfläche.
MsiPreviewBillboard Zeigt ein Billboard mit dem Hoststeuerelement 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 mithilfe der im Abschnitt "Installer Function Reference " aufgeführten Installationsprogrammfunktionen.