estrutura RPC_EXTENDED_ERROR_INFO (rpcasync.h)

Artigo
08/25/2023

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

Sintaxe

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;

Membros

Version

Versão da estrutura. Deve ser RPC_EEINFO_VERSION.

ComputerName

Nome DNS não qualificado, expresso em Unicode.

ProcessID

Identificador de processo para o evento de erro ofensivo.

u

u.SystemTime

Hora em que o registro foi gerado, expresso em segundos desde o início de 1º de janeiro de 1970, Horário de Greenwich (GMT), excluindo segundos bissextos. FileTime ou SystemTime é válido, com base em se EEInfoUseFileTime é usado no membro Flags.

u.FileTime

u.KernelTime

GeneratingComponent

Código para o componente que gerou o erro.

Status

Código de status do erro.

DetectionLocation

Código para o local de detecção. Consulte Locais de detecção de informações de erro estendidos para locais válidos.

Flags

Na entrada, especifica se SystemTime ou FileTime é usado. Defina como zero para usar SystemTime ou EEInfoUseFileTime para usar FileTime.

Na saída, especifica se os registros estão ausentes. Se um registro estiver ausente após o registro atual, Flags será definido como EEInfoNextRecordsMissing. Se um registro estiver ausente antes do registro atual, Flags será definido como EEInfoPreviousRecordsMissing.

NumberOfParameters

Número de parâmetros no membro Parameters .

Parameters[MaxNumberOfEEInfoParams]

Matriz de estruturas de RPC_EE_INFO_PARAM que contém as informações de erro estendidas.

Comentários

Na entrada, o chamador preenche apenas os membros Version e Flags da estrutura RPC_EXTENDED_ERROR_INFO . Todos os outros membros são preenchidos após a saída por RPC.

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

Requisitos


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)