Méthode IDebugFailureAnalysis ::GetString (extsfns.h)

Article
02/29/2024

La méthode GetString recherche dans un objet DebugFailureAnalysis 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, il obtient la valeur de chaîne ANSI à partir du bloc de données de l’entrée.

Syntaxe

PFA_ENTRY GetString(
  [in]  FA_TAG Tag,
  [out] PSTR   Str,
  [in]  ULONG  MaxSize
);

Paramètres

[in] Tag

Valeur dans l’énumération FA_TAG .

[out] Str

Pointeur vers une mémoire tampon qui reçoit la valeur de chaîne du bloc de données de l’entrée.

[in] MaxSize

Taille, en octets, de la mémoire tampon pointée par Str.

Valeur retournée

Si cette méthode trouve une entrée fa avec la balise spécifiée et si elle réussit à obtenir le bloc de données, elle retourne un pointeur vers la structure FA_ENTRY . Sinon, elle retourne NULL.

Remarques

Cette méthode copie une chaîne terminée par null du bloc de données de l’entrée vers la mémoire tampon pointée par Str. Cette méthode copie au maximum les caractères MaxSize , y compris la marque de fin NULL.

Chaque balise qui a déjà été utilisée dans un objet DebugFailureAnalysis 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 .

L’utilisation appropriée de cette méthode est d’obtenir le bloc de données à partir d’une entrée FA qui a un type de données DEBUG_FA_ENTRY_ANSI_STRING.