estrutura DRT_EVENT_DATA (drt.h)

Artigo
08/23/2023

A estrutura DRT_EVENT_DATA contém os dados de evento retornados chamando DrtGetEventData depois que um aplicativo recebe um sinal de evento no hEvent passado para DrtOpen.

Contém uma união sem nome que contém uma estrutura que define uma alteração no conjunto folha, o estado de uma chave registrada localmente ou o estado da instância drt local.

Sintaxe

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;

Membros

type

Um DRT_EVENT_TYPE enumeração que especifica o tipo de evento.

hr

O HRESULT da operação para a qual o evento foi sinalizado que indica se um resultado é o último resultado em uma pesquisa.

pvContext

Ponteiro para os dados de contexto passados para a API que gerou o evento. Por exemplo, se os dados forem passados para o parâmetro pvContext de DrtOpen, esses dados serão retornados por meio desse campo.

leafsetKeyChange

Essa estrutura aparece quando o evento foi gerado para sinalizar uma alteração em um conjunto folha de uma chave registrada localmente; o campo de tipo da estrutura DRT_EVENT_DATA é definido como DRT_EVENT_LEAFSET_KEY_CHANGED.

leafsetKeyChange.change

Especifica o tipo de alteração de chave que ocorreu.

leafsetKeyChange.localKey

Especifica a chave local associada ao conjunto de folhas que foi alterado.

leafsetKeyChange.remoteKey

Especifica a chave remota que foi alterada.

registrationStateChange

Essa estrutura aparece quando o evento foi gerado para sinalizar uma alteração em um registro de chave local; o campo tipo da estrutura DRT_EVENT_DATA é definido como DRT_EVENT_REGISTRATION_STATE_CHANGED.

registrationStateChange.state

Especifica o tipo de alteração de estado de registro que ocorreu.

registrationStateChange.localKey

Especifica a chave local associada ao registro que foi alterado.

statusChange

Essa estrutura aparece quando o evento foi gerado para sinalizar uma alteração de estado na instância drt local; o campo tipo da estrutura de DRT_EVENT_DATA é definido como DRT_EVENT_STATUS_CHANGED.

statusChange.status

Contém o DRT_STATUS atual da instância drt local.

statusChange.bootstrapAddresses

Essa estrutura contém os endereços retornados pelo provedor de inicialização quando o DRT tenta ingressar na malha. Essa estrutura é concluída somente quando o DRT faz a transição para o estado DRT_ALONE. O conteúdo dessa estrutura pode ser usado para diagnosticar problemas de conectividade entre a instância drt local e outros nós já presentes na malha.

statusChange.bootstrapAddresses.cntAddress

Contém o número de endereços em pAddresses.

statusChange.bootstrapAddresses.pAddresses

Contém uma matriz de endereços retornados pelo provedor de inicialização.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho	drt.h

Confira também