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.