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

Article
02/29/2024

La méthode GetUlong64 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 ULONG64 du bloc de données de l’entrée.

Syntaxe

PFA_ENTRY GetUlong64(
        FA_TAG   Tag,
  [out] PULONG64 Value
);

Paramètres

Tag

Valeur dans l’énumération FA_TAG .

[out] Value

Pointeur vers un ULONG64 qui reçoit la valeur 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

Si cette méthode trouve une entrée fa avec la balise spécifiée, elle vérifie si le membre DataSize de la structure FA_ENTRY est égal à la taille d’un ULONG64. Si DataSize n’est pas égal à la taille d’un ULONG64, cette méthode retourne NULL et n’obtient pas le bloc de données.

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_ULONG64 ou DEBUG_FA_ENTRY_INSTRUCTION_OFFSET ou DEBUG_FA_ENTRY_POINTER.