IDebugFailureAnalysis2 ::SetUlong, méthode (extsfns.h)

Article
02/06/2025

La méthode SetUlong 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, elle définit (remplace) le bloc de données de l’entrée FA sur une valeur ULONG 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 ULONG spécifiée.

Syntaxe

PFA_ENTRY SetUlong(
       FA_TAG Tag,
  [in] ULONG  Value
);

Paramètres

Tag

Valeur de l’énumération FA_TAG.

[in] Value

Valeur ULONG à é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_ULONG. Si le type de données associé à la balise n’est pas DEBUG_FA_ENTRY_ULONG, 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_ULONG.