DRT_EVENT_DATA結構 (drt.h)

DRT_EVENT_DATA結構包含在應用程式收到傳遞至DrtOpen之 hEvent上的事件訊號之後，呼叫DrtGetEventData所傳回的事件數據。

包含未命名的等位，其中包含定義分葉集中變更的結構、本機註冊密鑰的狀態，或本機 DRT 實例的狀態。

語法

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 結構的 type 字段會設定為 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實例的狀態變更訊號時，就會出現此結構;DRT_EVENT_DATA 結構的類型字段會設定為 DRT_EVENT_STATUS_CHANGED。

statusChange.status

包含本機DRT實例目前的 DRT_STATUS 。

statusChange.bootstrapAddresses

此結構包含DRT嘗試聯結網格時，啟動程式提供者所傳回的位址。 只有在DRT轉換為DRT_ALONE狀態時，才會完成此結構。 此結構的內容可用來診斷本機DRT實例與其他已存在於網狀結構中的節點之間的連線問題。

statusChange.bootstrapAddresses.cntAddress

包含 pAddresses 中的位址數目。

statusChange.bootstrapAddresses.pAddresses

包含啟動程式提供者傳回的位址陣列。

規格需求

需求	值
最低支援的用戶端	Windows 7 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
標頭	drt.h

另請參閱

DRT_EVENT_TYPE

DRT_STATUS

DrtGetEventData

DrtOpen