Functions > Process >


ShellExecuteWait

Exécute un programme externe en utilisant l'API ShellExecute et interrompt l'exécution du script jusqu'à ce qu'il se termine.

ShellExecuteWait ( "filename" [, "parameters" [, "workingdir" [, "verb" [, showflag]]]] )

Paramètres

filename Le nom du fichier à exécuter (.exe, .txt, .lnk, etc..).
parameters [optionnel] Les paramètres du programme. Vide ("") si aucun.
workingdir [optionnel] Le répertoire de travail. Si vide (""), utilise le répertoire de travail courant.
verb [optionnel] Le "verbe" à utiliser, les verbes courants sont:
    $SHEX_OPEN ("open") = Ouvre le fichier spécifié. Le fichier peut être un fichier exécutable, un fichier document ou un dossier
    $SHEX_EDIT ("edit") = lance un éditeur et ouvre le document pour l'éditer. Si "filename" n'est pas un fichier de document, la fonction échouera
    $SHEX_PRINT ("print") = Imprime le fichier de document spécifié. Si "filename" n'est pas un fichier de document, la fonction échouera
    $SHEX_PROPERTIES ("properties") = Affiche les propriétés d'un fichier ou d'un dossier
Voir Remarques pour plus d'information sur le comportement par défaut quand 'verb' n'est pas spécifié.

Les constantes sont définies dans "AutoItConstants.au3".
showflag [optionnel] Le flag "show" du programme exécuté:
    @SW_HIDE = Fenêtre cachée
    @SW_MINIMIZE = Fenêtre réduite
    @SW_MAXIMIZE = Fenêtre maximisée

Valeur de retour

Succès: Retourne le code de sortie du programme qui a été exécuté.
Échec: Définit @error <> 0.

Remarques

Après avoir exécuté le programme demandé le script s'interrompt jusqu'à ce que le programme demandé termine

Lorsqu'aucun verbe n'est spécifié, un verbe est utilisé par défaut. Le verbe par défaut est le verbe configuré dans le Registre. Si aucun verbe n'est défini par défaut dans le Registre, alors le verbe "open" est utilisé. Si le verbe "open" n'est pas présent, alors le premier verbe inscrit au registre est utilisé.

En relation

Run, RunAs, RunAsWait, RunWait, ShellExecute

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Exécute le Bloc-notes et attend que le processus du Bloc-notes se termine.
    Local $iReturn = ShellExecuteWait("notepad.exe")

    ; Affiche le code de retour du processus du Bloc-notes.
    MsgBox($MB_SYSTEMMODAL, "", "Le code de retour de Notepad était: " & $iReturn)
EndFunc   ;==>Example