RpcErrorClearInformation-Funktion (rpcasync.h)
Die RpcErrorClearInformation-Funktion löscht alle erweiterten Fehlerinformationen im aktuellen Thread.
Syntax
void RpcErrorClearInformation();
Rückgabewert
Diese Funktion verfügt über keine Rückgabewerte.
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
Hinweise
Die RPC-Runtime verarbeitet in der Regel das Löschen erweiterter Fehlerinformationen. In nur zwei Fällen sollten Aufrufer RpcErrorClearInformation verwenden:
- Wenn die aufrufende Komponente dem Thread mithilfe der RpcErrorAddRecord-Funktion Datensätze hinzufügt, entscheidet sie, dass kein schwerwiegender Fehler aufgetreten ist und die Verarbeitung des Originals fortgesetzt wird, oder der Fehler ist nicht mit den Datensätzen verbunden, wurde hinzugefügt. In diesem Fall muss die aufrufende Komponente die Fehlerinformationen aus dem Thread löschen, um die Weitergabe potenziell irreführender Fehlerinformationen zu verhindern.
- Wenn die aufrufende Komponente mehrere Wiederholungen eines Vorgangs versucht, der erweiterte Fehlerinformationen zurückgibt. Wenn ein RPC-Aufruf gestartet wird, löscht die RPC-Runtime alle erweiterten Fehlerinformationen im Thread. Wenn die aufrufende Komponente jedoch RpcErrorAddRecord in einer Schleife mit vielen Iterationen aufruft, möchte sie möglicherweise die Fehlerinformationen löschen, da sich die erweiterten Fehlerinformationen im Laufe der Zeit ansammeln und den verfügbaren Arbeitsspeicher aufgebraucht können.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rpcasync.h (rpc.h einschließen) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |