RoInspectCapturedStackBackTrace-Funktion (roerrorapi.h)

Bietet eine Möglichkeit für Debugger, eine Aufrufliste aus einem Zielprozess zu untersuchen.

Syntax

HRESULT RoInspectCapturedStackBackTrace(
  [in]           UINT_PTR                 targetErrorInfoAddress,
                 USHORT                   machine,
                 PINSPECT_MEMORY_CALLBACK readMemoryCallback,
  [in, optional] PVOID                    context,
  [out]          UINT32                   *frameCount,
  [out]          UINT_PTR                 *targetBackTraceAddress
);

Parameter

[in] targetErrorInfoAddress

Die Adresse des Fehlerinformationsobjekts im Zielprozess. Rufen Sie targetErrorInfoAddress ab, indem Sie die RoInspectThreadErrorInfo-Funktion aufrufen.

machine

Der zu debuggende Computer.

readMemoryCallback

Eine Rückruffunktion zum Lesen des Puffers aus dem ZIEL-TEB-Adressraum.

[in, optional] context

Benutzerdefinierte Kontextdaten.

[out] frameCount

Die Anzahl der im Fehlerobjekt gespeicherten Stapelframes.

[out] targetBackTraceAddress

Die Stapelrückverfolgungsadresse im Zielprozess.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die RoInspectCapturedStackBackTrace-Funktion verwendet einen Zeiger auf ein Systemfehlerobjekt und füllt frameCount mit der Anzahl der im Fehlerobjekt gespeicherten Stapelframes und füllt targetBackTraceAddress mit der Stapelrückverfolgungsadresse im Zielprozess aus. Die RoInspectCapturedStackBackTrace-Funktion versucht zu bestätigen, dass targetErrorInfoAddress auf ein Systemfehlerobjekt verweist, und schlägt fehl, wenn es nicht mit der Versionssignatur übereinstimmen kann.

Rufen Sie targetErrorInfoAddress ab, indem Sie die RoInspectThreadErrorInfo-Funktion aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	roerrorapi.h
Bibliothek	RuntimeObject.lib
DLL	ComBase.dll

Weitere Informationen

PINSPECT_MEMORY_CALLBACK

RoInspectThreadErrorInfo