IDebugFailureAnalysis::GetUlong64-Methode (extsfns.h)

Artikel
02/26/2024

Die GetUlong64-Methode durchsucht ein DebugFailureAnalysis-Objekt nach dem ersten FA-Eintrag , der über ein angegebenes Tag verfügt. Wenn es einen FA-Eintrag mit dem angegebenen Tag findet, 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-Enumeration .

[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 der Datenblock erfolgreich abrufen kann, gibt sie einen Zeiger auf die FA_ENTRY-Struktur zurück. Andernfalls wird NULL zurückgegeben.

Hinweise

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet, überprüft sie, ob das DataSize-Element der FA_ENTRY-Struktur der Größe eines ULONG64 entspricht. Wenn DataSize nicht der Größe eines ULONG64 entspricht, 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-Enumeration zugeordnet. Um den einem Tag zugeordneten Datentyp zu bestimmen, rufen Sie die GetType-Methode der IDebugFAEntryTags-Schnittstelle auf. Um einen Zeiger auf eine IDebugFAEntryTags-Schnittstelle abzurufen, rufen Sie die GetDebugFATagControl-Methode der IDebugFailureAnalysis2-Schnittstelle auf.

Die geeignete Verwendung dieser Methode besteht darin, den Datenblock aus einem FA-Eintrag abzurufen, der einen Datentyp von DEBUG_FA_ENTRY_ULONG64 oder DEBUG_FA_ENTRY_INSTRUCTION_OFFSET oder DEBUG_FA_ENTRY_POINTER aufweist.