RPC_EXTENDED_ERROR_INFO-Struktur (rpcasync.h)

Artikel
08/25/2023

Die RPC_EXTENDED_ERROR_INFO-Struktur wird verwendet, um erweiterte Fehlerinformationen zu speichern.

Syntax

typedef struct tagRPC_EXTENDED_ERROR_INFO {
  ULONG             Version;
  LPWSTR            ComputerName;
  ULONG             ProcessID;
  union {
    SYSTEMTIME    SystemTime;
    FILETIME      FileTime;
    LARGE_INTEGER KernelTime;
  } u;
  ULONG             GeneratingComponent;
  ULONG             Status;
  USHORT            DetectionLocation;
  USHORT            Flags;
  int               NumberOfParameters;
  RPC_EE_INFO_PARAM Parameters[MaxNumberOfEEInfoParams];
} RPC_EXTENDED_ERROR_INFO;

Members

Version

Version der -Struktur. Muss RPC_EEINFO_VERSION sein.

ComputerName

Nicht qualifizierter DNS-Name, ausgedrückt in Unicode.

ProcessID

Prozessbezeichner für das fehlerhafte Fehlerereignis.

u

u.SystemTime

Zeit, zu der der Datensatz generiert wurde, ausgedrückt in Sekunden seit Beginn des 1. Januar 1970, Greenwich Mean Time (GMT), ohne Schaltsekunden. Entweder FileTime oder SystemTime ist gültig, je nachdem, ob EEInfoUseFileTime im Flags-Element verwendet wird.

u.FileTime

u.KernelTime

GeneratingComponent

Code für die Komponente, die den Fehler generiert hat.

Status

Statuscode für den Fehler.

DetectionLocation

Code für den Erkennungsort. Gültige Speicherorte finden Sie unter Erweiterte Speicherorte zur Fehlerinformationserkennung .

Flags

Gibt bei der Eingabe an, ob SystemTime oder FileTime verwendet wird. Legen Sie auf Null fest, um SystemTime zu verwenden, oder EEInfoUseFileTime, um FileTime zu verwenden.

Gibt in der Ausgabe an, ob Datensätze fehlen. Wenn ein Datensatz nach dem aktuellen Datensatz fehlt, wird Flags auf EEInfoNextRecordsMissing festgelegt. Wenn ein Datensatz vor dem aktuellen Datensatz fehlt, wird Flags auf EEInfoPreviousRecordsMissing festgelegt.

NumberOfParameters

Anzahl der Parameter im Parameter-Element .

Parameters[MaxNumberOfEEInfoParams]

Array von RPC_EE_INFO_PARAM Strukturen, die die erweiterten Fehlerinformationen enthalten.

Hinweise

Bei der Eingabe füllt der Aufrufer nur die Member Version und Flags der RPC_EXTENDED_ERROR_INFO-Struktur aus. Alle anderen Member werden bei der Ausgabe durch RPC ausgefüllt.

Die RPC_EXTENDED_ERROR_INFO-Struktur wird in Verbindung mit den RpcError*-Funktionen verwendet, um erweiterte RPC-Fehlerinformationen zu untersuchen und zu erstellen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	rpcasync.h (rpc.h einschließen)