Anpassad åtgärdstyp 5
Den här anpassade åtgärden är skriven i JScript, till exempel ECMA 262. Windows Installer stöder inte JScript 1.0. Mer information finns i Scripts.
Källa
Skriptet genereras från en tillfällig binärström. Fältet Källa i tabellen CustomAction innehåller en nyckel till binär tabell. Kolumnen Data i tabellen Binär innehåller dataströmmen. En separat ström allokeras för varje rad.
Nya binära data kan infogas från en fil med hjälp av MsiRecordSetStream följt av MsiViewModify- för att infoga posten i tabellen. När den anpassade åtgärden anropas kopieras dataströmmen till en tillfällig fil som sedan bearbetas enligt typen av anpassad åtgärd.
Typvärde
Inkludera följande värde i kolumnen Typ i tabellen CustomAction för att ange den grundläggande numeriska typen av 32-bitars anpassad åtgärd.
Konstanter | Hexadecimal | Decimal |
---|---|---|
msidbCustomActionTypeJScript + msidbCustomActionTypeBinaryData | 0x05 | 5 |
Windows Installer kan använda 64-bitars anpassade åtgärder på 64-bitars operativsystem. En 64-bitars anpassad åtgärd baserad på skript måste innehålla msidbCustomActionType64BitScript bit i sin numeriska typ. Mer information finns i 64-bitars anpassade åtgärder. Inkludera följande värde i kolumnen Typ i tabellen CustomAction för att ange den grundläggande numeriska typen av en 64-bitars anpassad åtgärd.
Konstanter | Hexadecimal | Decimal |
---|---|---|
msidbCustomActionTypeJScript + msidbCustomActionTypeBinaryData + msidbCustomActionType64BitScript | 0x0001005 | 4101 |
Mål
Fältet Mål i tabellen CustomAction innehåller en valfri skriptfunktion. Bearbetning skickar först skriptet för parsning och anropar sedan den valfria skriptfunktionen.
Alternativ för returbearbetning
Inkludera valfria flaggbitar i kolumnen Typ i tabellen CustomAction för att ange alternativ för returbearbetning. En beskrivning av alternativen och värdena finns i Alternativ för returnering av anpassad åtgärd.
Schemaläggningsalternativ för körning
Inkludera valfria flaggbitar i kolumnen Typ i tabellen CustomAction för att ange alternativ för körningsschemaläggning. De här alternativen styr flera körningar av anpassade åtgärder. En beskrivning av alternativen finns i Schemaläggningsalternativ för anpassad åtgärdskörning.
In-Script körningsalternativ
Inkludera valfria flaggbitar i kolumnen Typ i tabellen CustomAction för att ange ett körningsalternativ i skriptet. De här alternativen kopierar åtgärdskoden till körnings-, återställnings- eller incheckningsskriptet. En beskrivning av alternativen finns i Anpassad åtgärd In-Script Körningsalternativ.
Returnera värden
Valfria funktioner som skrivs i skriptet måste returnera något av de värden som beskrivs i Return Values för JScript och VBScript Custom Actions.
Anmärkningar
En anpassad åtgärd som skrivs i JScript eller VBScript kräver installation av Sessionsobjekt. Installationsprogrammet kopplar objektet Session till skriptet med namnet Session. Eftersom session-objektet kanske inte finns under en installationsåterställning, måste en uppskjuten anpassad åtgärd som skrivits i skriptet använda någon av metoderna eller egenskaperna för Session-objektet som beskrivs i avsnittet Hämta kontextinformation för anpassade åtgärder för uppskjuten körning för att hämta kontexten.
När en databastabell exporteras skrivs varje dataström som en separat fil i undermappen med namnet efter tabellen med primärnyckeln som filnamn (namnkolumnen för den binära tabellen), med standardtillägget ".ibd". Namnet bör använda filnamnsformatet 8.3 om filsystemet eller versionskontrollsystemet inte stöder långa filnamn. Den beständiga arkivfilen ersätter dataströmmen med det filnamn som används, så att data kan finnas när tabellen importeras.
Relaterade ämnen