RPC_EXTENDED_ERROR_INFO structure

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;
  } 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

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

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

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

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Rpcasync.h (include Rpc.h)

RPC_EXTENDED_ERROR_INFO structure

Syntax

Members

Remarks

Requirements

See also