Retourwaarden van aangepaste JScript- en VBScript-acties

Aangepaste acties die zijn geschreven in JScript of Visual Basic, Scripting Edition (VBScript) kunnen een optionele functie aanroepen. Deze functies moeten een van de waarden retourneren die worden weergegeven in de volgende tabel.

Retourwaarde	Waarde	Beschrijving
msiDoActionStatusNoAction	0	De actie is niet uitgevoerd.
msiDoActionStatusSuccess	IDOK = 1	De actie is voltooid.
msiDoActionStatusUserExit	IDCANCEL = 2	Voortijdige beëindiging door gebruiker.
msiDoActionStatusFailure	IDABORT = 3	Onherstelbare fout. Geretourneerd als er een fout optreedt tijdens het parseren of uitvoeren van het JScript of VBScript.
msiDoActionStatusSuspend	IDRETRY = 4	Opgeschorte volgorde die later moet worden hervat.
msiDoActionStatusFinished	IDIGNORE = 5	Resterende acties overslaan. Geen fout.

 

Houd er rekening mee dat Windows Installer de retourwaarden van alle acties vertaalt wanneer de retourwaarde naar het logboekbestand wordt geschreven. Als de retourwaarde van de actie bijvoorbeeld wordt weergegeven als 1 (één) in het logboekbestand, betekent dit dat de actie msiDoActionStatusSuccess heeft geretourneerd. Zie Logboekregistratie van actie-retourwaardenvoor meer informatie over deze vertaling.

Als u een andere waarde wilt retourneren dan geslaagd van een aangepaste scriptactie, moet u een functiedoel gebruiken voor de aangepaste actie. De doelfunctie wordt opgegeven in de kolom Doel van de CustomAction Table.

In het volgende scriptvoorbeeld ziet u hoe u een aangepaste VBScript-actie kunt retourneren.

Function MyVBScriptCA()

    If Session.Property("CustomErrorStatus") <> "0" Then
        'return error
        MyVBScriptCA = 3
        Exit Function
    End If

    ' return success
    MyVBScriptCA = 1
    Exit Function

End Function

Als dit VBScript is ingesloten in de binaire tabel van het installatiepakket als MyCA.vbs, is de CustomAction Table vermelding voor het script het volgende:

Actie	Type	Bron	Doel
MyCustomAction	6	MyCA.vbs	MyVBScriptCA