DRT_EVENT_DATA structure (drt.h)

Article
08/23/2023

La structure DRT_EVENT_DATA contient les données d’événement retournées en appelant DrtGetEventData après qu’une application a reçu un signal d’événement sur l’événement hEvent passé dans DrtOpen.

Contient une union sans nom qui contient une structure qui définit une modification dans le jeu de feuilles, l’état d’une clé inscrite localement ou l’état de la DRT locale instance.

Syntaxe

typedef struct drt_event_data_tag {
  DRT_EVENT_TYPE type;
  HRESULT        hr;
  PVOID          pvContext;
  union {
    struct {
      DRT_LEAFSET_KEY_CHANGE_TYPE change;
      DRT_DATA                    localKey;
      DRT_DATA                    remoteKey;
    } leafsetKeyChange;
    struct {
      DRT_REGISTRATION_STATE state;
      DRT_DATA               localKey;
    } registrationStateChange;
    struct {
      DRT_STATUS status;
      struct {
        ULONG             cntAddress;
        PSOCKADDR_STORAGE pAddresses;
      } bootstrapAddresses;
    } statusChange;
  };
} DRT_EVENT_DATA, *PDRT_EVENT_DATA;

Membres

type

Énumération DRT_EVENT_TYPE qui spécifie le type d’événement.

hr

HRESULT de l’opération pour laquelle l’événement a été signalé qui indique si un résultat est le dernier résultat dans une recherche.

pvContext

Pointeur vers les données de contexte passées à l’API qui a généré l’événement. Par exemple, si des données sont passées dans le paramètre pvContext de DrtOpen, ces données sont retournées par le biais de ce champ.

leafsetKeyChange

Cette structure apparaît lorsque l’événement a été déclenché pour signaler une modification dans un jeu de feuilles d’une clé inscrite localement ; le champ type de la structure DRT_EVENT_DATA est défini sur DRT_EVENT_LEAFSET_KEY_CHANGED.

leafsetKeyChange.change

Spécifie le type de modification de clé qui s’est produite.

leafsetKeyChange.localKey

Spécifie la clé locale associée au jeu de feuilles qui a changé.

leafsetKeyChange.remoteKey

Spécifie la clé distante qui a changé.

registrationStateChange

Cette structure apparaît lorsque l’événement a été déclenché pour signaler un changement dans une inscription de clé locale ; le champ type de la structure DRT_EVENT_DATA a la valeur DRT_EVENT_REGISTRATION_STATE_CHANGED.

registrationStateChange.state

Spécifie le type de modification d’état d’inscription qui s’est produite.

registrationStateChange.localKey

Spécifie la clé locale associée à l’inscription qui a changé.

statusChange

Cette structure apparaît lorsque l’événement a été déclenché pour signaler un changement d’état dans le instance DRT local ; le champ de type de la structure DRT_EVENT_DATA est défini sur DRT_EVENT_STATUS_CHANGED.

statusChange.status

Contient la DRT_STATUS actuelle de la instance DRT locale.

statusChange.bootstrapAddresses

Cette structure contient les adresses retournées par le fournisseur d’amorçage lorsque la DRT tente de joindre le maillage. Cette structure est terminée uniquement lorsque la DRT passe à l’état DRT_ALONE. Le contenu de cette structure peut être utilisé pour diagnostiquer les problèmes de connectivité entre le instance DRT local et d’autres nœuds déjà présents dans le maillage.

statusChange.bootstrapAddresses.cntAddress

Contient le nombre d’adresses dans pAddresses.

statusChange.bootstrapAddresses.pAddresses

Contient un tableau d’adresses retourné par le fournisseur d’amorçage.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	drt.h

Voir aussi