DRT_EVENT_DATA 구조체(drt.h)

  • 아티클

DRT_EVENT_DATA 구조에는 애플리케이션이 DrtOpen에 전달된 hEvent의 이벤트 신호를 수신한 후 DrtGetEventData를 호출하여 반환된 이벤트 데이터가 포함됩니다.

리프 집합의 변경 내용, 로컬로 등록된 키의 상태 또는 로컬 DRT instance 상태를 정의하는 구조체를 포함하는 명명되지 않은 공용 구조체를 포함합니다.

구문

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;

멤버

type

이벤트 유형을 지정하는 DRT_EVENT_TYPE 열거형입니다.

hr

결과가 검색 내의 마지막 결과인지를 나타내는 이벤트가 신호를 받은 작업의 HRESULT입니다.

pvContext

이벤트를 생성한 API에 전달된 컨텍스트 데이터에 대한 포인터입니다. 예를 들어 데이터가 DrtOpen의 pvContext 매개 변수에 전달되면 해당 데이터가 이 필드를 통해 반환됩니다.

leafsetKeyChange

이 구조는 로컬로 등록된 키의 리프 집합에 변경 신호를 표시하기 위해 이벤트가 발생했을 때 나타납니다. DRT_EVENT_DATA 구조체의 형식 필드가 DRT_EVENT_LEAFSET_KEY_CHANGED 설정됩니다.

leafsetKeyChange.change

발생한 키 변경의 유형을 지정합니다.

leafsetKeyChange.localKey

변경된 리프 집합과 연결된 로컬 키를 지정합니다.

leafsetKeyChange.remoteKey

변경된 원격 키를 지정합니다.

registrationStateChange

이 구조는 로컬 키 등록의 변경을 알리기 위해 이벤트가 발생했을 때 나타납니다. DRT_EVENT_DATA 구조체의 형식 필드가 DRT_EVENT_REGISTRATION_STATE_CHANGED 설정됩니다.

registrationStateChange.state

발생한 등록 상태 변경 유형을 지정합니다.

registrationStateChange.localKey

변경된 등록과 연결된 로컬 키를 지정합니다.

statusChange

이 구조체는 로컬 DRT instance 상태 변경을 알리기 위해 이벤트가 발생할 때 나타납니다. DRT_EVENT_DATA 구조체의 형식 필드는 DRT_EVENT_STATUS_CHANGED 설정됩니다.

statusChange.status

로컬 DRT instance 현재 DRT_STATUS 포함합니다.

statusChange.bootstrapAddresses

이 구조체에는 DRT가 메시 조인을 시도할 때 부트스트랩 공급자가 반환하는 주소가 포함됩니다. 이 구조는 DRT가 DRT_ALONE 상태로 전환되는 경우에만 완료됩니다. 이 구조체의 내용은 로컬 DRT instance 메시에 이미 있는 다른 노드 간의 연결 문제를 진단하는 데 사용할 수 있습니다.

statusChange.bootstrapAddresses.cntAddress

pAddresses의 주소 수를 포함합니다.

statusChange.bootstrapAddresses.pAddresses

부트스트랩 공급자가 반환하는 주소 배열을 포함합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 Professional [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글 drt.h

추가 정보

DRT_EVENT_TYPE

DRT_STATUS

DrtGetEventData

DrtOpen