DRT_EVENT_DATA structure (drt.h)
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 |