struttura DRT_EVENT_DATA (drt.h)

Articolo
08/23/2023

La struttura DRT_EVENT_DATA contiene i dati dell'evento restituiti chiamando DrtGetEventData dopo che un'applicazione riceve un segnale di evento nel hEvent passato in DrtOpen.

Contiene un'unione senza nome che contiene una struttura che definisce una modifica nel set foglia, lo stato di una chiave registrata localmente o lo stato dell'istanza DRT locale.

Sintassi

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;

Members

type

Enumerazione DRT_EVENT_TYPE che specifica il tipo di evento.

hr

HRESULT dell'operazione per cui è stato segnalato l'evento che indica se un risultato è l'ultimo risultato all'interno di una ricerca.

pvContext

Puntatore ai dati di contesto passati all'API che ha generato l'evento. Ad esempio, se i dati vengono passati al parametro pvContext di DrtOpen, tali dati vengono restituiti tramite questo campo.

leafsetKeyChange

Questa struttura viene visualizzata quando l'evento è stato generato per segnalare una modifica in un set foglia di una chiave registrata localmente; il campo type della struttura DRT_EVENT_DATA è impostato su DRT_EVENT_LEAFSET_KEY_CHANGED.

leafsetKeyChange.change

Specifica il tipo di modifica della chiave che si è verificata.

leafsetKeyChange.localKey

Specifica la chiave locale associata al set foglia modificato.

leafsetKeyChange.remoteKey

Specifica la chiave remota modificata.

registrationStateChange

Questa struttura viene visualizzata quando l'evento è stato generato per segnalare una modifica in una registrazione della chiave locale; il campo type della struttura DRT_EVENT_DATA è impostato su DRT_EVENT_REGISTRATION_STATE_CHANGED.

registrationStateChange.state

Specifica il tipo di modifica dello stato di registrazione che si è verificata.

registrationStateChange.localKey

Specifica la chiave locale associata alla registrazione modificata.

statusChange

Questa struttura viene visualizzata quando l'evento è stato generato per segnalare una modifica dello stato nell'istanza DRT locale; il campo type della struttura DRT_EVENT_DATA è impostato su DRT_EVENT_STATUS_CHANGED.

statusChange.status

Contiene la DRT_STATUS corrente dell'istanza DRT locale.

statusChange.bootstrapAddresses

Questa struttura contiene gli indirizzi restituiti dal provider bootstrap quando DRT tenta di unire la mesh. Questa struttura viene completata solo quando DRT passa allo stato DRT_ALONE. Il contenuto di questa struttura può essere usato per diagnosticare i problemi di connettività tra l'istanza DRT locale e altri nodi già presenti nella mesh.

statusChange.bootstrapAddresses.cntAddress

Contiene il numero di indirizzi in pAddresses.

statusChange.bootstrapAddresses.pAddresses

Contiene una matrice di indirizzi restituiti dal provider bootstrap.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 Professional [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	drt.h

Vedi anche