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

Article
02/06/2025

La méthode SetUlong64 recherche un objet DebugFailureAnalysis pour le premier entrée FA qui a une balise spécifiée. S’il trouve une entrée fa avec la balise spécifiée, elle définit (remplace) le bloc de données de l’entrée FA sur une valeur ULONG64 spécifiée. Si cette méthode ne trouve pas d’entrée de fa qui a la balise spécifiée, elle crée une entrée FA avec cette balise et définit le bloc de données de la nouvelle entrée FA sur la valeur ULONG64 spécifiée.

Syntaxe

PFA_ENTRY SetUlong64(
       FA_TAG  Tag,
  [in] ULONG64 Value
);

Paramètres

Tag

Valeur de l’énumération FA_TAG.

[in] Value

Valeur ULONG64 à écrire dans le bloc de données de l’entrée fa nouvelle ou existante.

Valeur de retour

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

Remarques

Si cette méthode trouve une entrée fa avec la balise spécifiée, elle vérifie si le type de données associé à cette balise est DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSETou DEBUG_FA_ENTRY_POINTER. Si le type de données associé à la balise n’a pas l’une de ces trois valeurs, cette méthode retourne NULL et ne remplace pas le bloc de données de l’entrée.

Si cette méthode ne trouve pas d’entrée fa avec la balise spécifiée, elle crée une entrée FA avec cette balise et associe la balise au type de données DEBUG_FA_ENTRY_ULONG64.