DRT_EVENT_DATA estructura (drt.h)

Artículo
08/23/2023

La estructura de DRT_EVENT_DATA contiene los datos de evento devueltos mediante una llamada a DrtGetEventData después de que una aplicación reciba una señal de evento en el hEvent pasado a DrtOpen.

Contiene una unión sin nombre que contiene una estructura que define un cambio en el conjunto hoja, el estado de una clave registrada localmente o el estado de la instancia de DRT local.

Sintaxis

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;

Miembros

type

Enumeración DRT_EVENT_TYPE que especifica el tipo de evento.

hr

HRESULT de la operación para la que se señalizó el evento que indica si un resultado es el último resultado dentro de una búsqueda.

pvContext

Puntero a los datos de contexto pasados a la API que generó el evento. Por ejemplo, si los datos se pasan al parámetro pvContext de DrtOpen, esos datos se devuelven a través de este campo.

leafsetKeyChange

Esta estructura aparece cuando se ha generado el evento para indicar un cambio en un conjunto hoja de una clave registrada localmente; el campo de tipo de la estructura de DRT_EVENT_DATA se establece en DRT_EVENT_LEAFSET_KEY_CHANGED.

leafsetKeyChange.change

Especifica el tipo de cambio de clave que se ha producido.

leafsetKeyChange.localKey

Especifica la clave local asociada al conjunto hoja que ha cambiado.

leafsetKeyChange.remoteKey

Especifica la clave remota que cambió.

registrationStateChange

Esta estructura aparece cuando se ha generado el evento para indicar un cambio en un registro de clave local; el campo de tipo de la estructura de DRT_EVENT_DATA se establece en DRT_EVENT_REGISTRATION_STATE_CHANGED.

registrationStateChange.state

Especifica el tipo de cambio de estado de registro que se ha producido.

registrationStateChange.localKey

Especifica la clave local asociada al registro que ha cambiado.

statusChange

Esta estructura aparece cuando se ha generado el evento para indicar un cambio de estado en la instancia de DRT local; El campo de tipo de la estructura de DRT_EVENT_DATA se establece en DRT_EVENT_STATUS_CHANGED.

statusChange.status

Contiene el DRT_STATUS actual de la instancia de DRT local.

statusChange.bootstrapAddresses

Esta estructura contiene las direcciones devueltas por el proveedor de arranque cuando el DRT intenta unir la malla. Esta estructura solo se completa cuando el DRT pasa al estado DRT_ALONE. El contenido de esta estructura se puede usar para diagnosticar problemas de conectividad entre la instancia de DRT local y otros nodos que ya están presentes en la malla.

statusChange.bootstrapAddresses.cntAddress

Contiene el número de direcciones en pAddresses.

statusChange.bootstrapAddresses.pAddresses

Contiene una matriz de direcciones devueltas por el proveedor de arranque.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	drt.h

Consulte también