IDebugFailureAnalysis::GetUlong64-Methode (extsfns.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | extsfns.h |
Weitere Informationen
Schreiben eines Analyseerweiterungs-Plug-Ins zum Erweitern von !analyze