GetRestrictedErrorInfo-Funktion (roerrorapi.h)

Artikel
08/25/2023

Ruft das eingeschränkte Fehlerinformationsobjekt ab, das durch einen vorherigen Aufruf von SetRestrictedErrorInfo im aktuellen logischen Thread festgelegt wurde.

Syntax

HRESULT GetRestrictedErrorInfo(
  [out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);

Parameter

[out] ppRestrictedErrorInfo

Das dem aktuellen Thread zugeordnete Objekt mit eingeschränkten Fehlerinformationen.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Das eingeschränkte Fehlerobjekt wurde erfolgreich abgerufen.
S_FALSE	Dem aktuellen Thread ist kein eingeschränktes Fehlerobjekt zugeordnet. Alle anderen Fehlerobjekte werden aus dem Thread entfernt.

Hinweise

Rufen Sie die GetRestrictedErrorInfo-Funktion auf, um das zuletzt festgelegte IRestrictedErrorInfo-Objekt im aktuellen Thread in einer Windows Store-App abzurufen.

Rufen Sie die RoCaptureErrorContext-Funktion auf, um Fehlerinformationen für den aktuellen Thread zu speichern. Rufen Sie die RoFailFastWithErrorContext-Funktion auf, um eine Ausnahme auszulösen, den aktuellen Prozess zu beenden und den Fehler an den Windows-Fehlerberichterstattung-Dienst (WER) zu melden.

GetRestrictedErrorInfo überträgt den Besitz des Fehlerobjekts an den Aufrufer und löscht den Fehlerstatus für den Thread. Wenn das zuletzt festgelegte Fehlerobjekt die IRestrictedErrorInfo-Schnittstelle nicht unterstützt, wird der Fehlerzustand für den Thread gelöscht, aber keine Schnittstelle wird an den Aufrufer zurückgegeben.

GetRestrictedErrorInfo ruft das Fehlerobjekt aus dem aktuellen Thread ab und ruft QueryInterface auf, um die IRestrictedErrorInfo-Schnittstelle zu finden. Wenn IRestrictedErrorInfo nicht gefunden wird, gibt GetRestrictedErrorInfoS_FALSE zurück. In diesem Fall wird das Fehlerobjekt aus dem Thread entfernt. Weitere Informationen finden Sie unter GetErrorInfo.

Beim Aufrufen der GetRestrictedErrorInfo-Funktion tritt ein Fehler auf, wenn IRestrictedErrorInfo nicht die Systemimplementierung ist. Um ein IRestrictedErrorInfo-Objekt zu erstellen, rufen Sie die Funktionen "OriginateError", "TransformError" oder " RoCaptureErrorContext " auf.

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
DLL	Combase.dll