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 |