DRT_EVENT_DATA Struktur (drt.h)

Die DRT_EVENT_DATA-Struktur enthält die Ereignisdaten, die durch Aufrufen von DrtGetEventData zurückgegeben werden, nachdem eine Anwendung ein Ereignissignal für das an DrtOpen übergebene hEvent empfangen hat.

Enthält eine unbenannte Union, die eine Struktur enthält, die eine Änderung im Blattsatz, den Zustand eines lokal registrierten Schlüssels oder den Zustand des lokalen DRT-instance definiert.

Syntax

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;

Member

type

Eine DRT_EVENT_TYPE-Enumeration , die den Ereignistyp angibt.

hr

Das HRESULT des Vorgangs, für den das Ereignis signalisiert wurde, gibt an, ob ein Ergebnis das letzte Ergebnis innerhalb einer Suche ist.

pvContext

Zeiger auf die Kontextdaten, die an die API übergeben werden, die das Ereignis generiert hat. Wenn beispielsweise Daten an den pvContext-Parameter von DrtOpen übergeben werden, werden diese Daten über dieses Feld zurückgegeben.

leafsetKeyChange

Diese Struktur wird angezeigt, wenn das Ereignis ausgelöst wurde, um eine Änderung in einem Blattsatz eines lokal registrierten Schlüssels zu signalisieren. Das Typfeld der DRT_EVENT_DATA-Struktur ist auf DRT_EVENT_LEAFSET_KEY_CHANGED festgelegt.

leafsetKeyChange.change

Gibt den Typ der Aufgetretenen Schlüsseländerung an.

leafsetKeyChange.localKey

Gibt den lokalen Schlüssel an, der dem geänderten Blattsatz zugeordnet ist.

leafsetKeyChange.remoteKey

Gibt den geänderten Remoteschlüssel an.

registrationStateChange

Diese Struktur wird angezeigt, wenn das Ereignis ausgelöst wurde, um eine Änderung in einer lokalen Schlüsselregistrierung zu signalisieren. Das Typfeld der DRT_EVENT_DATA-Struktur ist auf DRT_EVENT_REGISTRATION_STATE_CHANGED festgelegt.

registrationStateChange.state

Gibt den Typ der vorgenommenen Änderung des Registrierungsstatus an.

registrationStateChange.localKey

Gibt den lokalen Schlüssel an, der der geänderten Registrierung zugeordnet ist.

statusChange

Diese Struktur wird angezeigt, wenn das Ereignis ausgelöst wurde, um eine Zustandsänderung im lokalen DRT-instance zu signalisieren. Das Typfeld der DRT_EVENT_DATA-Struktur ist auf DRT_EVENT_STATUS_CHANGED festgelegt.

statusChange.status

Enthält den aktuellen DRT_STATUS des lokalen DRT-instance.

statusChange.bootstrapAddresses

Diese Struktur enthält die Adressen, die vom Bootstrapanbieter zurückgegeben werden, wenn der DRT versucht, das Gitternetz zu verknüpfen. Diese Struktur wird nur abgeschlossen, wenn die DRT in den zustand DRT_ALONE wechselt. Der Inhalt dieser Struktur kann verwendet werden, um Konnektivitätsprobleme zwischen dem lokalen DRT-instance und anderen Knoten zu diagnostizieren, die bereits im Gitter vorhanden sind.

statusChange.bootstrapAddresses.cntAddress

Enthält die Anzahl der Adressen in pAddresses.

statusChange.bootstrapAddresses.pAddresses

Enthält ein Array von Adressen, die vom Bootstrapanbieter zurückgegeben werden.

Anforderungen

Weitere Informationen

DRT_EVENT_TYPE

DRT_STATUS

DrtGetEventData

DrtOpen