IDebugFailureAnalysis2::SetUlong64-Methode (extsfns.h)

Artikel
02/06/2025

Die SetUlong64--Methode durchsucht ein DebugFailureAnalysis--Objekt für den ersten FA-Eintrag mit einem angegebenen Tag. Wenn ein FA-Eintrag mit dem angegebenen Tag gefunden wird, wird der Datenblock des FA-Eintrags auf einen angegebenen ULONG64-Wert festgelegt (überschrieben). Wenn diese Methode keinen FA-Eintrag mit dem angegebenen Tag findet, erstellt sie einen neuen FA-Eintrag mit diesem Tag und legt den Datenblock des neuen FA-Eintrags auf den angegebenen ULONG64 Wert fest.

Syntax

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

Parameter

Tag

Ein Wert in der FA_TAG-Aufzählung.

[in] Value

Der ULONG64 Wert, der in den Datenblock des neuen oder vorhandenen FA-Eintragsgeschrieben werden soll.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird ein Zeiger auf die neue oder vorhandene FA_ENTRY Struktur zurückgegeben. Andernfalls wird NULL-zurückgegeben.

Bemerkungen

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet, wird überprüft, ob der diesem Tag zugeordnete Datentyp DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSEToder DEBUG_FA_ENTRY_POINTERist. Wenn der dem Tag zugeordnete Datentyp keinen dieser drei Werte aufweist, gibt diese Methode NULL zurück und überschreibt den Datenblock des Eintrags nicht.

Wenn diese Methode keinen FA-Eintrag mit dem angegebenen Tag findet, erstellt sie einen neuen FA-Eintrag mit diesem Tag und ordnet das Tag dem Datentyp DEBUG_FA_ENTRY_ULONG64zu.