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.
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 |