Méthode IDebugControl ::ExecuteCommandFile (dbgeng.h)

Article
02/23/2024

La méthode ExecuteCommandFile ouvre le fichier spécifié et exécute les commandes de débogueur contenues dans.

Syntaxe

HRESULT ExecuteCommandFile(
  [in] ULONG OutputControl,
  [in] PCSTR CommandFile,
  [in] ULONG Flags
);

Paramètres

[in] OutputControl

Spécifie où envoyer la sortie de la commande. Pour connaître les valeurs possibles, consultez DEBUG_OUTCTL_XXX. Pour plus d’informations sur la sortie, consultez Entrée et Sortie.

[in] CommandFile

Spécifie le nom du fichier qui contient les commandes à exécuter. Ce fichier est ouvert pour lecture et son contenu est interprété comme s’il avait été tapé dans la console du débogueur.

[in] Flags

Spécifie les options d’exécution de la commande. Les options par défaut sont de journaliser la commande, mais pas de l’envoyer à la sortie. Pour plus d’informations sur les valeurs que les indicateurs peuvent prendre, consultez Exécuter.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur, y compris les valeurs d’erreur provoquées par l’échec de l’ouverture du fichier spécifié. Pour plus d’informations, consultez Valeurs de retour.

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

Cette méthode lit le fichier spécifié et exécute les commandes une ligne à la fois à l’aide de Execute. Si une exception s’est produite lors de l’exécution d’une ligne, l’exécution se poursuit avec la ligne suivante.