IDebugFailureAnalysis2 ::SetExtensionCommand, méthode (extsfns.h)

Article
02/06/2025

La méthode SetExtensionCommand recherche un objet DebugFailureAnalysis pour la première entrée fa qui a une balise spécifiée. S’il trouve une entrée fa avec la balise spécifiée, elle définit (remplace) le bloc de données de l’entrée FA sur une chaîne de commande d’extension spécifiée. Si cette méthode ne trouve pas d’entrée fa qui a la balise spécifiée, elle crée une entrée FA avec cette balise et définit le bloc de données de la nouvelle entrée FA sur la chaîne de commande d’extension spécifiée.

Syntaxe

PFA_ENTRY SetExtensionCommand(
  FA_TAG Tag,
  PCSTR  Extension
);

Paramètres

Tag

Valeur de l’énumération FA_TAG.

Extension

Pointeur vers une chaîne terminée par null qui est la commande d’extension. Un exemple de commande d’extension est « !analyze -v ».

Valeur de retour

Si cette méthode réussit, elle retourne un pointeur vers la structure FA_ENTRY nouvelle ou existante. Sinon, elle retourne NULL .

Remarques

Si cette méthode trouve une entrée fa avec la balise spécifiée, elle vérifie si le type de données associé à cette balise est DEBUG_FA_ENTRY_EXTENSION_CMD ou DEBUG_FA_ENTRY_ANSI_STRING. Si le type de données associé à la balise n’a pas l’une de ces deux valeurs, cette méthode retourne NULL et ne remplace pas le bloc de données de l’entrée.

Si cette méthode ne trouve pas d’entrée fa avec la balise spécifiée, elle crée une entrée FA avec cette balise et associe la balise au type de données DEBUG_FA_ENTRY_EXTENSION_CMD.