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

See also

Obtaining Extended RPC Error Information

RPC_EE_INFO_PARAM

RPC_ERROR_ENUM_HANDLE

RpcErrorAddRecord

RpcErrorClearInformation

RpcErrorEndEnumeration

RpcErrorGetNextRecord

RpcErrorGetNumberOfRecords

RpcErrorLoadErrorInfo

RpcErrorResetEnumeration

RpcErrorSaveErrorInfo

RpcErrorStartEnumeration