struktur DRT_EVENT_DATA (drt.h)
Struktur DRT_EVENT_DATA berisi data peristiwa yang dikembalikan dengan memanggil DrtGetEventData setelah aplikasi menerima sinyal peristiwa pada hEvent yang diteruskan ke DrtOpen.
Berisi union yang tidak disebutkan namanya yang berisi struktur yang menentukan perubahan dalam kumpulan daun, status kunci yang terdaftar secara lokal, atau status instans DRT lokal.
Sintaks
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;
Anggota
type
Enumerasi DRT_EVENT_TYPE yang menentukan jenis peristiwa.
hr
HRESULT operasi yang diberi sinyal peristiwa yang menunjukkan apakah hasilnya adalah hasil terakhir dalam pencarian.
pvContext
Arahkan ke data konteks yang diteruskan ke API yang menghasilkan peristiwa. Misalnya, jika data diteruskan ke parameter pvContextDrtOpen, data tersebut dikembalikan melalui bidang ini.
leafsetKeyChange
Struktur ini muncul ketika peristiwa telah dinaikkan untuk menandakan perubahan kumpulan daun kunci yang terdaftar secara lokal; bidang jenis struktur DRT_EVENT_DATA diatur ke DRT_EVENT_LEAFSET_KEY_CHANGED.
leafsetKeyChange.change
Menentukan jenis perubahan kunci yang telah terjadi.
leafsetKeyChange.localKey
Menentukan kunci lokal yang terkait dengan kumpulan daun yang telah berubah.
leafsetKeyChange.remoteKey
Menentukan kunci jarak jauh yang berubah.
registrationStateChange
Struktur ini muncul ketika peristiwa telah dinaikkan untuk menandakan perubahan pendaftaran kunci lokal; bidang jenis struktur DRT_EVENT_DATA diatur ke DRT_EVENT_REGISTRATION_STATE_CHANGED.
registrationStateChange.state
Menentukan jenis perubahan status pendaftaran yang telah terjadi.
registrationStateChange.localKey
Menentukan kunci lokal yang terkait dengan pendaftaran yang telah berubah.
statusChange
Struktur ini muncul ketika peristiwa telah dinaikkan untuk memberi sinyal perubahan status dalam instans DRT lokal; bidang jenis struktur DRT_EVENT_DATA diatur ke DRT_EVENT_STATUS_CHANGED.
statusChange.status
Berisi DRT_STATUS instans DRT lokal saat ini.
statusChange.bootstrapAddresses
Struktur ini berisi alamat yang dikembalikan oleh penyedia bootstrap ketika DRT mencoba bergabung dengan jala. Struktur ini selesai hanya ketika DRT beralih ke status DRT_ALONE. Konten struktur ini dapat digunakan untuk mendiagnosis masalah konektivitas antara instans DRT lokal dan simpul lain yang sudah ada di jala.
statusChange.bootstrapAddresses.cntAddress
Berisi jumlah alamat dalam pAddresses.
statusChange.bootstrapAddresses.pAddresses
Berisi array alamat yang dikembalikan oleh penyedia bootstrap.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 7 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Header | drt.h |