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

Article
02/29/2024

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

Syntaxe

PFA_ENTRY GetUlong(
  [in]  FA_TAG Tag,
  [out] PULONG Value
);

Paramètres

[in] Tag

Valeur dans l’énumération FA_TAG .

[out] Value

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

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 . Dans le cas contraire, elle retourne LA VALEUR 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 terminaison 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.