structure RPC_EXTENDED_ERROR_INFO (rpcasync.h)

Article
08/25/2023

La structure RPC_EXTENDED_ERROR_INFO est utilisée pour stocker des informations d’erreur étendues.

Syntaxe

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;

Membres

Version

Version de la structure. Doit être RPC_EEINFO_VERSION.

ComputerName

Nom DNS non qualifié, exprimé en Unicode.

ProcessID

Identificateur de processus pour l’événement d’erreur incriminé.

u

u.SystemTime

Heure de génération de l’enregistrement, exprimée en secondes depuis le début du 1er janvier 1970, heure moyenne de Greenwich (GMT), à l’exclusion des secondes bissextiles. FileTime ou SystemTime est valide, selon que EEInfoUseFileTime est utilisé dans le membre Flags.

u.FileTime

u.KernelTime

GeneratingComponent

Code pour le composant qui a généré l’erreur.

Status

Code d’état de l’erreur.

DetectionLocation

Code pour l’emplacement de détection. Pour connaître les emplacements valides, consultez Emplacements de détection d’informations d’erreur étendues .

Flags

En entrée, spécifie si SystemTime ou FileTime est utilisé. Définissez sur zéro pour utiliser SystemTime, ou sur EEInfoUseFileTime pour utiliser FileTime.

Sur la sortie, spécifie si les enregistrements sont manquants. Si un enregistrement est manquant après l’enregistrement actif, Flags est défini sur EEInfoNextRecordsMissing. Si un enregistrement est manquant avant l’enregistrement actif, Flags est défini sur EEInfoPreviousRecordsMissing.

NumberOfParameters

Nombre de paramètres dans le membre Paramètres .

Parameters[MaxNumberOfEEInfoParams]

Tableau de structures RPC_EE_INFO_PARAM contenant les informations d’erreur étendues.

Notes

Lors de l’entrée, l’appelant remplit uniquement les membres Version et Flags de la structure RPC_EXTENDED_ERROR_INFO . Tous les autres membres sont renseignés lors de la sortie par RPC.

La structure RPC_EXTENDED_ERROR_INFO est utilisée conjointement avec les fonctions RpcError* pour examiner et créer des informations d’erreur RPC étendues.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	rpcasync.h (inclure Rpc.h)