estrutura RPC_EE_INFO_PARAM (rpcasync.h)

Artigo
08/25/2023

A estrutura RPC_EE_INFO_PARAM é usada para armazenar informações de erro estendidas.

Sintaxe

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;

Membros

ParameterType

Tipo de parâmetro que está sendo fornecido como informações de erro estendidas. Esse valor determina quais membros da união são usados. Os valores válidos são os seguintes:

eeptAnsiString para especificar uma cadeia de caracteres ANSI, indicando que o valor é fornecido em AnsiString.
eeptUnicodeString para especificar uma cadeia de caracteres Unicode, indicando que o valor é fornecido em UnicodeString.
eeptLongVal para especificar um valor LONG, indicando que o valor é fornecido em LVal.
eeptShortVal para especificar um valor SHORT, indicando que os valores são fornecidos em SVal.
eeptPointerVal para especificar um valor de ponteiro, indicando que os valores são fornecidos em PVal.
eeptBinary é usado pelo RPC Runtime e não deve ser usado ou especificado por aplicativos.
eeptNone indica que o parâmetro continha uma cadeia de caracteres Unicode ou ANSI, mas foi truncado devido à falta de memória ou limitações de comprimento do fragmento de rede.

u

u.AnsiString

Cadeia de caracteres ANSI que representa as informações de erro estendidas.

u.UnicodeString

Cadeia de caracteres Unicode que representa as informações de erro estendidas.

u.LVal

Valor longo que representa as informações de erro estendidas.

u.SVal

Valor curto que representa as informações de erro estendidas.

u.PVal

Valor ULONGLONG que representa as informações de erro estendidas.

u.BVal

Reservado.

Comentários

A estrutura RPC_EE_INFO_PARAM é usada em conjunto com as funções RpcError* para investigar e criar informações de erro RPC estendidas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	rpcasync.h (inclua Rpc.h)