RPC_EXTENDED_ERROR_INFO structure (rpcasync.h)
The RPC_EXTENDED_ERROR_INFO structure is used to store extended error information.
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 of the structure. Must be RPC_EEINFO_VERSION.
ComputerName
Non-qualified DNS name, expressed in Unicode.
ProcessID
Process identifier for the offending error event.
u
u.SystemTime
Time the record was generated, expressed in seconds since the beginning of January 1, 1970, Greenwich Mean Time (GMT), excluding leap seconds. Either FileTime or SystemTime is valid, based on whether EEInfoUseFileTime is used in the Flags member.
u.FileTime
Time the record was generated, expressed in seconds since the beginning of January 1, 1970, Greenwich Mean Time (GMT), excluding leap seconds. Either FileTime or SystemTime is valid, based on whether EEInfoUseFileTime is used in the Flags member..
u.KernelTime
GeneratingComponent
Code for the component that generated the error.
Status
Status code for the error.
DetectionLocation
Code for the detection location. See Extended Error Information Detection Locations for valid locations.
Flags
On input, specifies whether SystemTime or FileTime is used. Set to zero to use SystemTime, or EEInfoUseFileTime to use FileTime.
On output, specifies whether records are missing. If a record is missing after the current record, Flags is set to EEInfoNextRecordsMissing. If a record is missing before the current record, Flags is set to EEInfoPreviousRecordsMissing.
NumberOfParameters
Number of parameters in the Parameters member.
Parameters[MaxNumberOfEEInfoParams]
Array of RPC_EE_INFO_PARAM structures containing the extended error information.
Remarks
On input, the caller fills in only the Version and Flags members of the RPC_EXTENDED_ERROR_INFO structure. All other members are filled upon output by RPC.
The RPC_EXTENDED_ERROR_INFO structure is used in conjunction with the RpcError* functions to investigate and create extended RPC error information.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Header | rpcasync.h (include Rpc.h) |