Freigeben über


RoCaptureErrorContext-Funktion (roerrorapi.h)

Speichert den aktuellen Fehlerkontext, sodass er für spätere Aufrufe der Funktion RoFailFastWithErrorContext verfügbar ist.

Syntax

HRESULT RoCaptureErrorContext(
  HRESULT hr
);

Parameter

hr

Das dem Fehler zugeordnete HRESULT .

Rückgabewert

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

Hinweise

Die RoCaptureErrorContext-Funktion erfasst den kontext, der einem Fehler zugeordnet ist, einschließlich des Stapelrückverfolgungs. Diese Informationen werden im eingeschränkten Fehlerobjekt gespeichert und stehen dem Windows-Fehlerberichterstattung -Dienst (WER) zur Verfügung, wenn WER aktiviert ist und wenn ein späterer Aufruf der RoFailFastWithErrorContext-Funktion aus demselben Thread erfolgt.

Um die RoCaptureErrorContext-Funktion mit RoOriginateError zu verwenden, rufen Sie zuerst RoOriginateError auf, und rufen Sie dann RoCaptureErrorContext auf. Das Aufrufen in umgekehrter Reihenfolge kann dazu führen, dass der Fehlerkontext verloren geht.

Anforderungen

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

Weitere Informationen

IRestrictedErrorInfo

RoFailFastWithErrorContext

RoOriginateError

RoOriginateErrorW