Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
);
Die Parameter
[out] ppRestrictedErrorInfo
Das eingeschränkte Fehlerinformationsobjekt, das dem aktuellen Thread zugeordnet ist.
Rückgabewert
Diese Funktion kann einen dieser Werte zurückgeben.
| Rückgabecode | Description |
|---|---|
|
Das eingeschränkte Fehlerobjekt wurde erfolgreich abgerufen. |
|
Dem aktuellen Thread ist kein eingeschränktes Fehlerobjekt zugeordnet. Jedes andere Fehlerobjekt wird aus dem Thread entfernt. |
Bemerkungen
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-Fehlerberichterstattungsdienst (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 Fehlerstatus für den Thread gelöscht, aber keine Schnittstelle 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.
Das Aufrufen der GetRestrictedErrorInfo-Funktion schlägt fehl, wenn IRestrictedErrorInfo nicht die Systemimplementierung ist. Rufen Sie zum Erstellen eines IRestrictedErrorInfo-Objekts die Funktionen "OriginateError", "TransformError" oder "RoCaptureErrorContext " auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows 8 [Desktop-Apps | UWP-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Fenster |
| Header | roerrorapi.h |
| Library | mincore.lib |
| DLL | Combase.dll |