Méthode IDebugFailureAnalysis2 ::SetString (extsfns.h)

La méthode SetString recherche la première entrée FA qui a une balise spécifiée dans un objet DebugFailureAnalysis. S’il trouve une entrée FA avec la balise spécifiée, il définit (remplace) le bloc de données de l’entrée FA sur une valeur de chaîne 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 nouvelle entrée FA avec cette balise et définit le bloc de données de la nouvelle entrée FA sur la valeur de chaîne spécifiée.

Syntaxe

PFA_ENTRY SetString(
       FA_TAG Tag,
  [in] PCSTR  Str
);

Paramètres

Tag

Valeur dans l’énumération FA_TAG .

[in] Str

Pointeur vers une chaîne ANSI terminée par null à écrire dans le bloc de données de l’entrée FA nouvelle ou existante.

Valeur retournée

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_ANSI_STRING ou DEBUG_FA_ENTRY_EXTENSION_CMD. Si le type de données associé à la balise n’est pas l’un de ces deux types, 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 nouvelle entrée FA avec cette balise et associe la balise au type de données DEBUG_FA_ENTRY_ANSI_STRING.

Configuration requise

Voir aussi

AddString

IDebugFailureAnalysis2

Écriture d’un plug-in d’extension d’analyse pour Étendre !analyze

_EFN_Analyze