Benutzerdefinierter Aktionstyp 21

Diese benutzerdefinierte Aktion wird in JScript geschrieben, z. B. ECMA 262. Windows Das Installationsprogramm unterstützt JScript 1.0 nicht. Weitere Informationen finden Sie unter Skripts.

Source

Das Skript wird während der aktuellen Sitzung mit der Anwendung installiert. Das Feld Source der CustomAction-Tabelle enthält einen Schlüssel für die Dateitabelle. Der Speicherort des benutzerdefinierten Aktionscodes wird durch die Auflösung des Zielpfads für diese Datei bestimmt. Daher muss diese benutzerdefinierte Aktion aufgerufen werden, nachdem die Datei installiert und entfernt wurde.

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 Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile 0x015 21

Windows Das Installationsprogramm kann benutzerdefinierte 64-Bit-Aktionen auf 64-Bit-Betriebssystemen verwenden. Eine benutzerdefinierte 64-Bit-Aktion, die auf Skripts basiert, muss das bit msidbCustomActionType64BitScript in seinem numerischen Typ enthalten. Weitere Informationen finden Sie unter Benutzerdefinierte 64-Bit-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 Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001015 4117

Ziel

Das Feld Target 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.

Optionen für die Rückgabeverarbeitung

Schließen Sie optionale Flagbits in die Spalte Typ der CustomAction-Tabelle ein, um Rückgabeverarbeitungsoptionen anzugeben. Eine Beschreibung der Optionen und Werte finden Sie unter Rückgabeverarbeitungsoptionen für benutzerdefinierte Aktionen.

Optionen für die Ausführungsplanung

Schließen Sie optionale Flagbits in die Spalte Typ der CustomAction-Tabelle ein, um Optionen für die Ausführungsplanung anzugeben. Diese Optionen steuern die mehrfache Ausführung benutzerdefinierter Aktionen. Eine Beschreibung der Optionen finden Sie unter Optionen für die Benutzerdefinierte Aktionsausführungsplanung.

In-Script Ausführungsoptionen

Schließen Sie optionale Flagbits in die Spalte Typ der CustomAction-Tabelle ein, um eine Skriptausführungsoption anzugeben. Diese Optionen kopieren den Aktionscode in das Ausführungs-, Rollback- oder Commitskript. Eine Beschreibung der Optionen finden Sie unter Benutzerdefinierte Aktion In-Script Ausführungsoptionen.

Rückgabewerte

Optionale Funktionen, die im Skript geschrieben werden, müssen einen der unter Rückgabewerte von JScript und benutzerdefinierten VBScript-Aktionen beschriebenen Werte zurückgeben.

Bemerkungen

Für eine benutzerdefinierte Aktion, die in JScript VBScript geschrieben ist, ist das Session-Installationsobjekt erforderlich. Das Installationsprogramm hängt das Sitzungsobjekt mit dem Namen "Session" an das Skript an. Da das Session-Objekt während eines Installationsrollbacks möglicherweise nicht vorhanden ist, muss eine verzögerte benutzerdefinierte Aktion, die im Skript geschrieben wurde, eine der Methoden oder Eigenschaften des Session-Objekts verwenden, die im Abschnitt Abrufen von Kontextinformationen für benutzerdefinierte Aktionen mit verzögerter Ausführung beschrieben sind, um den Kontext abzurufen.

Benutzerdefinierte Aktionen, die auf eine installierte Datei als Quelle verweisen, z. B. Benutzerdefinierter Aktionstyp 21 (JScript), müssen die folgenden Sequenzierungseinschränkungen einhalten:

Benutzerdefinierte _ Aktionen