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