Delen via


Aangepast actietype 21

Deze aangepaste actie wordt geschreven in JScript, zoals ECMA 262. Windows Installer biedt geen ondersteuning voor JScript 1.0. Zie Scriptsvoor meer informatie.

Bron

Het script wordt tijdens de huidige sessie met de toepassing geïnstalleerd. Het veld Bron van de CustomAction-tabel bevat een sleutel voor de tabel Bestand. De locatie van de aangepaste actiecode wordt bepaald door de resolutie van het doelpad voor dit bestand; daarom moet deze aangepaste actie worden aangeroepen nadat het bestand is geïnstalleerd en voordat het wordt verwijderd.

Typewaarde

Neem de volgende waarde op in de kolom Type van de CustomAction-tabel om het numerieke basistype van een 32-bits aangepaste actie op te geven.

Constanten Hexadecimaal Decimaal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile 0x015 21

 

Windows Installer kan gebruikmaken van 64-bits aangepaste acties op 64-bits besturingssystemen. Een 64-bits aangepaste actie op basis van scripts moet de msidbCustomActionType64BitScript bit in het numerieke type bevatten. Zie 64-bits aangepaste acties voor meer informatie. Neem de volgende waarde op in de kolom Type van de CustomAction-tabel om het numerieke basistype van een 64-bits aangepaste actie op te geven.

Constanten Hexadecimaal Decimaal
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001015 4117

 

Doel

Het veld Target van de CustomAction-tabel bevat een optionele scriptfunctie. De verwerking verzendt eerst het script voor parseren en roept vervolgens de optionele scriptfunctie aan.

Opties voor retourverwerking

Voeg optionele vlag-bits toe in de kolom Type van de CustomAction-tabel om retourverwerkingsopties op te geven. Zie Aangepaste opties voor retourverwerkingvoor een beschrijving van de opties en waarden.

Opties voor het plannen van de uitvoering

Voeg optionele vlag-bits toe in de kolom Type van de CustomAction-tabel om de planningsopties voor de uitvoering op te geven. Deze opties bepalen de meerdere uitvoering van aangepaste acties. Zie Opties voor het plannen van aangepaste actiesvoor een beschrijving van de opties.

In-Script uitvoeringsopties

Voeg optionele vlag-bits toe in de kolom Type van de CustomAction-tabel om een optie voor het uitvoeren van scripts op te geven. Met deze opties kopieert u de actiecode naar het uitvoerings-, terugdraai- of doorvoerscript. Zie Aangepaste actie In-Script uitvoeringsoptiesvoor een beschrijving van de opties.

Retourwaarden

Optionele functies die in het script zijn geschreven, moeten een van de waarden retourneren die worden beschreven in Retourwaarden van JScript- en VBScript Custom Actions.

Opmerkingen

Een aangepaste actie die is geschreven in JScript of VBScript vereist de installatie Session-object. Het installatieprogramma koppelt het Sessieobject aan het script met de naam Sessie. Omdat het sessie--object mogelijk niet bestaat tijdens het terugdraaien van de installatie, moet een uitgestelde aangepaste actie die in het script is geschreven, een van de methoden of eigenschappen van het Session-object gebruiken dat wordt beschreven in de sectie Contextinformatie verkrijgen voor aangepaste acties voor uitgestelde uitvoering om de context op te halen.

Aangepaste acties die verwijzen naar een geïnstalleerd bestand als bron, zoals Aangepast actietype 21 (JScript), moeten voldoen aan de volgende sequentiebeperkingen:

  • De aangepaste actie moet worden gesequentieerd na de actie CostFinalize. Dit is zodat de aangepaste actie het pad kan oplossen dat nodig is om het bronbestand met het JScript te zoeken.
  • Als het bronbestand nog niet op de computer is geïnstalleerd, moeten aangepaste acties van dit type (in-script) worden gesequentieerd na de actie InstallFiles.
  • Als het bronbestand nog niet op de computer is geïnstalleerd, moeten niet-uitgestelde aangepaste acties van dit type worden gesequentieerd na de InstallFinalize-actie.

Custom_Actions