Udostępnij za pośrednictwem


Niestandardowy typ akcji 21

Ta akcja niestandardowa jest napisana w języku JScript, takim jak ECMA 262. Instalator Windows nie obsługuje języka JScript 1.0. Aby uzyskać więcej informacji, zobacz Scripts.

Źródło

Skrypt jest instalowany z aplikacją podczas bieżącej sesji. Pole Źródło tabeli CustomAction zawiera klucz do tabeli File. Lokalizacja kodu akcji niestandardowej jest określana przez rozdzielczość ścieżki docelowej dla tego pliku; w związku z tym ta akcja niestandardowa musi być wywoływana po zainstalowaniu pliku i przed jego usunięciem.

Wartość typu

Uwzględnij następującą wartość w kolumnie Typ tabeli CustomAction, aby określić podstawowy typ liczbowy 32-bitowej akcji niestandardowej.

Stałe Szesnastkowych Dziesiętny
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile 0x015 21

 

Instalator Windows może używać 64-bitowych akcji niestandardowych w 64-bitowych systemach operacyjnych. 64-bitowa akcja niestandardowa oparta na skryptach musi zawierać msidbCustomActionType64BitScript bit w typie liczbowym. Aby uzyskać informacje, zobacz 64-bitowe akcje niestandardowe. Uwzględnij następującą wartość w kolumnie Typ tabeli CustomAction, aby określić podstawowy typ liczbowy 64-bitowej akcji niestandardowej.

Stałe Szesnastkowych Dziesiętny
msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001015 4117

 

Cel

Pole Target tabeli CustomAction zawiera opcjonalną funkcję skryptu. Przetwarzanie najpierw wysyła skrypt do analizy, a następnie wywołuje opcjonalną funkcję skryptu.

Opcje przetwarzania zwrotnego

Uwzględnij opcjonalne bity flagi w kolumnie Typ tabeli CustomAction w celu określenia opcji przetwarzania zwrotnego. Aby zapoznać się z opisem opcji i wartości, zobacz Opcje przetwarzania powrotnego akcji niestandardowej.

Opcje planowania wykonywania

Dołącz opcjonalne bity flagi w kolumnie Typ tabeli CustomAction, aby określić opcje planowania wykonywania. Te opcje kontrolują wielokrotne wykonywanie akcji niestandardowych. Aby uzyskać opis opcji, zobacz Opcje planowania wykonywania akcji niestandardowych.

Opcje wykonywania In-Script

Dołącz opcjonalne bity flagi w kolumnie Typ tabeli CustomAction, aby określić opcję wykonywania skryptu. Te opcje kopiują kod akcji do skryptu wykonywania, wycofywania lub zatwierdzania. Aby zapoznać się z opisem opcji, zobacz opcje wykonywania niestandardowego In-Script.

Zwracane wartości

Opcjonalne funkcje napisane w skrypcie muszą zwracać jedną z wartości opisanych w zwracanych wartości JScript i VBScript Custom Actions.

Uwagi

Akcja niestandardowa napisana w JScript lub VBScript wymaga obiektusesjiinstalacji. Instalator dołącza obiekt sesji do skryptu o nazwie "Sesja". Ponieważ obiekt sesji może nie istnieć podczas wycofywania instalacji, odroczona akcja niestandardowa napisana w skrycie musi używać jednej z metod lub właściwości obiektu sesji opisanego w sekcji Uzyskiwanie informacji kontekstowych dla akcji niestandardowych odroczonego wykonywania w celu pobrania kontekstu.

Akcje niestandardowe odwołujące się do zainstalowanego pliku jako źródła, takie jak niestandardowy typ akcji 21 (JScript), muszą być zgodne z następującymi ograniczeniami sekwencjonowania:

  • Akcja niestandardowa musi być sekwencjonowana po akcji CostFinalize. Dzięki temu akcja niestandardowa może rozpoznać ścieżkę potrzebną do zlokalizowania pliku źródłowego zawierającego kod JScript.
  • Jeśli plik źródłowy nie jest jeszcze zainstalowany na komputerze, akcje niestandardowe tego typu (skrypt) odroczone (skrypt) muszą być sekwencjonowane po akcji InstallFiles.
  • Jeśli plik źródłowy nie jest jeszcze zainstalowany na komputerze, akcje niestandardowe tego typu nieodroczone muszą być sekwencjonowane po akcji InstallFinalize.

Custom_Actions