Partager via

Valeurs de retour des actions personnalisées JScript et VBScript

Les actions personnalisées écrites dans JScript ou Visual Basic, Scripting Edition (VBScript) peuvent appeler une fonction facultative. Ces fonctions doivent retourner l’une des valeurs indiquées dans le tableau suivant.

Valeur de retour Valeur Description
msiDoActionStatusNoAction 0 Action non exécutée.
msiDoActionStatusSuccess IDOK = 1 L’action s’est terminée avec succès.
msiDoActionStatusUserExit IDCANCEL = 2 Arrêt prématuré par l’utilisateur.
msiDoActionStatusFailure IDABORT = 3 Erreur irrécupérable. Retourné s’il existe une erreur lors de l’analyse ou de l’exécution de JScript ou VBScript.
msiDoActionStatusSuspend IDRETRY = 4 Séquence suspendue à reprendre ultérieurement.
msiDoActionStatusFinished IDIGNORE = 5 Ignorez les actions restantes. Pas une erreur.

 

Notez que Windows Installer traduit les valeurs de retour de toutes les actions lorsqu’il écrit la valeur de retour dans le fichier journal. Par exemple, si la valeur de retour de l’action apparaît sous la forme 1 (une) dans le fichier journal, cela signifie que l’action a retourné msiDoActionStatusSuccess. Pour plus d’informations sur cette traduction, consultez journalisation des valeurs de retour d’action.

Pour retourner une valeur autre que la réussite d’une action personnalisée de script, vous devez utiliser une cible de fonction pour l’action personnalisée. La fonction cible est spécifiée dans la colonne Cible de l'table CustomAction.

L’exemple de script suivant vous montre comment retourner la réussite ou l’échec à partir d’une action personnalisée VBScript.

Function MyVBScriptCA()

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

    ' return success
    MyVBScriptCA = 1
    Exit Function

End Function

Si ce VBScript a été incorporé dans la table binaire du package d’installation en tant que MyCA.vbs, l’entrée CustomAction Table pour le script est la suivante :

Action Type Source Cible
MyCustomAction 6 MyCA.vbs MyVBScriptCA

 

 

 

  • Last updated on