Benutzerdefinierter Aktionstyp 22

Diese benutzerdefinierte Aktion wird in VBScript geschrieben. Siehe auch Skripts.

Quelle

Das Skript wird während der aktuellen Sitzung mit der Anwendung installiert. Das Quellfeld der CustomAction-Tabelle enthält einen Schlüssel zur 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 wurde und bevor sie entfernt 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.

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.

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 Session Object. Dies ist der Typ Session Object und das Installationsprogramm fügt es mit dem Skript mit dem Namen "Session" 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.

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

• Die benutzerdefinierte Aktion muss nach der CostFinalize-Aktionsequenziert werden. Dies ist so, dass die benutzerdefinierte Aktion den Pfad auflösen kann, der zum Suchen der Quelldatei mit dem VBScript erforderlich ist.
• Wenn die Quelldatei noch nicht auf dem Computer installiert ist, müssen benutzerdefinierte Aktionen dieses Typs nach der InstallFiles-Aktionsequenziert werden.
• Wenn die Quelldatei noch nicht auf dem Computer installiert ist, müssen nicht verzögerte benutzerdefinierte Aktionen dieses Typs nach der InstallFinalize-Aktionsequenziert werden.

Verwandte Themen

Custom_Actions