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

Article
02/06/2025

La méthode AddString ajoute une nouvelle entrée fa à un objet DebugFailureAnalysis et définit le bloc de données de l’entrée FA sur une chaîne spécifiée.

Syntaxe

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

Paramètres

Tag

Valeur de l’énumération FA_TAG. Le type de données associé à cette balise doit être DEBUG_FA_ENTRY_ANSI_STRING.

[in] Str

Pointeur vers une chaîne ANSI terminée par null à écrire dans le bloc de données de la nouvelle entrée fa de .

Valeur de retour

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

Remarques

Cette méthode définit le membre DataSize de la nouvelle structure de FA_ENTRY sur la longueur, en octets, de la chaîne, y compris le point de terminaison NULL.

Chaque balise est associée à l’un des types de données de l’énumération FA_ENTRY_TYPE. Pour déterminer le type de données associé à une balise, appelez la méthode GetType de l’interface IDebugFAEntryTags.

Pour obtenir un pointeur vers une interface IDebugFAEntryTags, appelez la méthode GetDebugFATagControl de l’interface IDebugFailureAnalysis2.