RpcErrorClearInformation-Funktion (rpcasync.h)

  • Artikel

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

Weitere Informationen

Abrufen erweiterter RPC-Fehlerinformationen

RpcErrorAddRecord

RpcErrorGetNextRecord

RpcErrorStartEnumeration