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

Article
02/26/2024

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 dans 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 un caractère Null à écrire dans le bloc de données de la nouvelle entrée FA.

Valeur retournée

Si cette méthode réussit, elle retourne un 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 FA_ENTRY sur la longueur, en octets, de la chaîne, y compris la marque de fin 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 .