RpcErrorAddRecord-Funktion (rpcasync.h)

Die RpcErrorAddRecord-Funktion fügt einer Kette erweiterter Fehlerinformationsdatensätze hinzu.

Syntax

RPC_STATUS RpcErrorAddRecord(
  [in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);

Parameter

[in] ErrorInfo

Hinzuzufügende Fehlerinformationen in Form einer RPC_EXTENDED_ERROR_INFO-Struktur .

Rückgabewert

Der erfolgreiche Abschluss gibt RPC_S_OK zurück.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

 

Hinweise

Mit der RpcErrorAddRecord-Funktion können andere Anwendungen oder Server als die RPC-Runtime erweiterten Fehlerinformationen zu einer Kette erweiterter Fehlerinformationsdatensätze hinzufügen.

Die Verantwortung für die Zeichenfolgen, auf die von ErrorInfo verwiesen wird, gehören dem Aufrufer; Die RpcErrorAddRecord-Funktion erstellt bei Bedarf eine Kopie dieser Zeichenfolgen. Die folgenden Einschränkungen für die Member von ErrorInfo müssen beachtet werden:

Version muss auf eine gültige Version festgelegt werden, z. B. RPC_EEINFO_VERSION.

ComputerName muss auf NULL festgelegt werden. Jeder andere Wert führt zu ERROR_INVALID_PARAMETER.

ProcessID muss auf Null festgelegt werden. Jeder andere Wert führt zu ERROR_INVALID_PARAMETER.

SystemTime oder FileTime wird bei der Eingabe ignoriert und von der RPC-Runtime festgelegt.

GeneratingComponent muss auf Null festgelegt werden. Jeder andere Wert führt zu ERROR_INVALID_PARAMETER. Die RPC-Runtime legt dies auf EEInfoGCApplication fest.

Der Status kann auf den Fehlercode festgelegt werden, den der Aufrufer der Kette hinzufügen möchte.

DetectionLocation muss auf Null festgelegt werden. Jeder andere Wert führt zu ERROR_INVALID_PARAMETER.

NumberOfParameters gibt die Anzahl der Parameter im Parameterarray an. Dieser Wert muss gleich oder größer als 0 oder MaxNumberOfEEInfoParams sein. Die RPC-Runtime verwendet nach der angegebenen Anzahl von Parametern keinen Arbeitsspeicher, sodass Aufrufer Speicher für weniger als MaxNumberOfEEInfoParams-Parameter sicher zuweisen können.

Parameter stellt die Parameter für den erweiterten Fehlerinformationssatz dar. Die einzige Einschränkung für Parameter besteht darin, dass Pval verwendet wird, um Zeiger darzustellen, und ist immer 64 Bits. Verwenden Sie Pval unabhängig davon, ob das verwendete System 32 Bit oder 64 Bit ist. Verwenden Sie Lval nicht.

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 (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

Abrufen erweiterter RPC-Fehlerinformationen

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration