RPC_EE_INFO_PARAM structure (rpcasync.h)

The RPC_EE_INFO_PARAM structure is used to store extended error information.

Syntax

typedef struct tagRPC_EE_INFO_PARAM {
  ExtendedErrorParamTypes ParameterType;
  union {
    LPSTR       AnsiString;
    LPWSTR      UnicodeString;
    long        LVal;
    short       SVal;
    ULONGLONG   PVal;
    BinaryParam BVal;
  } u;
} RPC_EE_INFO_PARAM;

Members

ParameterType

Type of parameter being provided as extended error information. This value determines which union member(s) is used. Valid values are the following:

  • eeptAnsiString to specify an ANSI string, indicating the value is provided in AnsiString.
  • eeptUnicodeString to specify a Unicode string, indicating the value is provided in UnicodeString.
  • eeptLongVal to specify a LONG value, indicating the value is provided in LVal.
  • eeptShortVal to specify a SHORT value, indicating the values is provided in SVal.
  • eeptPointerVal to specify a pointer value, indicating the values is provided in PVal.
  • eeptBinary is used by the RPC Runtime and should not be used or specified by applications.
  • eeptNone indicates the parameter contained either a Unicode or ANSI string, but was truncated due to lack of memory or network fragment length limitations.

u

u.AnsiString

ANSI string representing the extended error information.

u.UnicodeString

Unicode string representing the extended error information.

u.LVal

Long value representing the extended error information.

u.SVal

Short value representing the extended error information.

u.PVal

ULONGLONG value representing the extended error information.

u.BVal

Reserved.

Remarks

The RPC_EE_INFO_PARAM 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)

See also

Obtaining Extended RPC Error Information

RPC_ERROR_ENUM_HANDLE

RPC_EXTENDED_ERROR_INFO

RpcErrorAddRecord

RpcErrorClearInformation

RpcErrorEndEnumeration

RpcErrorGetNextRecord

RpcErrorGetNumberOfRecords

RpcErrorLoadErrorInfo

RpcErrorResetEnumeration

RpcErrorSaveErrorInfo

RpcErrorStartEnumeration