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

Article
02/06/2025

La méthode SetString 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 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 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 de 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 de FA nouvelle ou existante.

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_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 entrée FA avec cette balise et associe la balise au type de données DEBUG_FA_ENTRY_ANSI_STRING.