Benutzerdefinierter Aktionstyp 6
Diese benutzerdefinierte Aktion wird in VBScript geschrieben. Weitere Informationen finden Sie unter Skripts.
Quelle
Das Skript wird aus einem temporären binären Datenstrom generiert. Das Quellfeld der CustomAction-Tabelle enthält einen Schlüssel zur Binary-Tabelle. Die Datenspalte in der Binärtabelle enthält die Datenstromdaten. Jeder Zeile wird ein separater Datenstrom zugewiesen.
Neue Binärdaten können aus einer Datei eingefügt werden, indem MsiRecordSetStream- gefolgt von MsiViewModify, um den Datensatz in die Tabelle einzufügen. Wenn die benutzerdefinierte Aktion aufgerufen wird, werden die Datenstromdaten in eine temporäre Datei kopiert, die dann abhängig vom Typ der benutzerdefinierten Aktion verarbeitet wird.
Typwert
Fügen Sie den folgenden Wert in die Spalte "Typ" der CustomAction-Tabelle ein, um den grundlegenden numerischen Typ einer benutzerdefinierten 32-Bit-Aktion anzugeben.
Konstanten | Hexadezimal | Dezimal |
---|---|---|
msidbCustomActionTypeVBScript + msidbCustomActionTypeBinaryData- | 0x006 | 6 |
Windows Installer kann benutzerdefinierte 64-Bit-Aktionen auf 64-Bit-Betriebssystemen verwenden. Eine benutzerdefinierte 64-Bit-Aktion, die auf Skripts basiert, muss das msidbCustomActionType64BitScript- Bit in seinem numerischen Typ enthalten. Weitere Informationen finden Sie unter 64-Bit-für benutzerdefinierte Aktionen. Fügen Sie den folgenden Wert in die Spalte "Typ" der CustomAction-Tabelle ein, um den grundlegenden numerischen Typ einer benutzerdefinierten 64-Bit-Aktion anzugeben.
Konstanten | Hexadezimal | Dezimal |
---|---|---|
msidbCustomActionTypeVBScript + msidbCustomActionTypeBinaryData + msidbCustomActionType64BitScript- | 0x0001006 | 4102 |
Ziel
Das Zielfeld der CustomAction-Tabelle enthält eine optionale Skriptfunktion. Die Verarbeitung sendet zuerst das Skript für die Analyse und ruft dann die optionale Skriptfunktion auf.
Rückgabeverarbeitungsoptionen
Fügen Sie optionale Flagbits in die Spalte "Typ" der CustomAction-Tabelle ein, um Rückgabeverarbeitungsoptionen anzugeben. Eine Beschreibung der Optionen und werte finden Sie unter Benutzerdefinierte Aktion Rückgabeverarbeitungsoptionen.
Ausführungsplanungsoptionen
Fügen Sie optionale Flagbits in die Spalte "Typ" der CustomAction-Tabelle ein, um Ausführungsplanungsoptionen anzugeben. Diese Optionen steuern die mehrfache Ausführung von benutzerdefinierten Aktionen. Eine Beschreibung der Optionen finden Sie unter Benutzerdefinierte Optionen für die Ausführung von Aktionen.
In-Script Ausführungsoptionen
Fügen Sie optionale Flagbits in die Spalte "Typ" der CustomAction-Tabelle ein,, um eine In-Script-Ausführungsoption anzugeben. Mit diesen Optionen wird der Aktionscode in das Ausführungs-, Rollback- oder Commitskript kopiert. Eine Beschreibung der Optionen finden Sie unter Benutzerdefinierte Aktion In-Script Ausführungsoptionen.
Rückgabewerte
Optionale Funktionen, die in Skript geschrieben wurden, müssen einen der werte zurückgeben, die in Rückgabewerte von benutzerdefinierten Aktionen von JScript und VBScriptbeschrieben werden.
Bemerkungen
Eine benutzerdefinierte Aktion, die in JScript oder VBScript geschrieben wurde, erfordert die Installation des Session Object. Das Installationsprogramm fügt das Session-Objekt mit dem Namen Sessionan das Skript an. Da das Session-Objekt während eines Installationsrollbacks möglicherweise nicht vorhanden ist, muss eine verzögerte benutzerdefinierte Aktion, die in Skript geschrieben wurde, eine der Methoden oder Eigenschaften des Session-Objekt verwenden, das im Abschnitt Abrufen von Kontextinformationen für benutzerdefinierte Deferred Execution Custom Actions zum Abrufen des Kontexts beschrieben wird.
Wenn eine Datenbanktabelle exportiert wird, wird jeder Datenstrom als separate Datei im Unterordner geschrieben, der nach der Tabelle benannt ist, wobei der Primärschlüssel als Dateiname (Name-Spalte für die Binärtabelle) mit der Standarderweiterung ".ibd" verwendet wird. Der Name sollte das 8.3-Dateinamenformat verwenden, wenn das Dateisystem oder das Versionsverwaltungssystem keine langen Dateinamen unterstützt. Die permanente Archivdatei ersetzt die Datenstromdaten durch den verwendeten Dateinamen, sodass die Daten beim Importieren der Tabelle gefunden werden können.
Verwandte Themen