IDebugFailureAnalysis::GetUlong64-Methode (extsfns.h)

Artikel
02/06/2025

Die GetUlong64--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, ruft er den ULONG64 Wert aus dem Datenblock des Eintrags ab.

Syntax

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

Parameter

Tag

Ein Wert in der FA_TAG-Aufzählung.

[out] Value

Ein Zeiger auf eine ULONG64, die den Wert aus dem Datenblock des Eintrags empfängt.

Rückgabewert

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet und es erfolgreich ist, den Datenblock abzurufen, wird ein Zeiger auf die 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 das DataSize-Element der FA_ENTRY-Struktur der Größe eines ULONG64entspricht. Wenn DataSize- nicht der Größe eines ULONG64entspricht, gibt diese Methode NULL- zurück und ruft den Datenblock nicht ab.

Jedes Tag, das bereits in einem DebugFailureAnalysis-Objekt verwendet wurde, ist einem der Datentypen in der FA_ENTRY_TYPE-Aufzählung zugeordnet. Um den einem Tag zugeordneten Datentyp zu ermitteln, rufen Sie die GetType--Methode der IDebugFAEntryTags Schnittstelle auf. Rufen Sie zum Abrufen eines Zeigers auf eine IDebugFAEntryTags-Schnittstelle die GetDebugFATagControl Methode der IDebugFailureAnalysis2 Schnittstelle auf.

Die entsprechende Verwendung dieser Methode ist das Abrufen des Datenblocks aus einem FA-Eintrag mit einem Datentyp von DEBUG_FA_ENTRY_ULONG64 oder DEBUG_FA_ENTRY_INSTRUCTION_OFFSET oder DEBUG_FA_ENTRY_POINTER.