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