struktur PEER_GROUP_EVENT_DATA (p2p.h)

2024-03-13

Struktur PEER_GROUP_EVENT_DATA berisi informasi tentang peristiwa grup serekan tertentu yang telah terjadi.

Sintaks

typedef struct peer_group_event_data_tag {
  PEER_GROUP_EVENT_TYPE eventType;
  union {
    PEER_GROUP_STATUS                 dwStatus;
    PEER_EVENT_INCOMING_DATA          incomingData;
    PEER_EVENT_RECORD_CHANGE_DATA     recordChangeData;
    PEER_EVENT_CONNECTION_CHANGE_DATA connectionChangeData;
    PEER_EVENT_MEMBER_CHANGE_DATA     memberChangeData;
    HRESULT                           hrConnectionFailedReason;
  };
} PEER_GROUP_EVENT_DATA, *PPEER_GROUP_EVENT_DATA;

Anggota

eventType

PEER_GROUP_EVENT_TYPE nilai enumerasi yang menentukan jenis peristiwa grup serekan yang terjadi. Jenis peristiwa menentukan struktur berikutnya yang dipilih dari serikat; misalnya, jika nilai ini diatur ke PEER_GROUP_EVENT_INCOMING_DATA, anggota serikat yang diisi adalah incomingData.

dwStatus

Menentukan nilai bendera PEER_GROUP_STATUS yang menunjukkan status baru grup serekan. Bidang ini diisi jika peristiwa PEER_GROUP_EVENT_STATUS_CHANGED dinaikkan.

incomingData

Menentukan struktur PEER_EVENT_INCOMING_DATA yang berisi informasi tentang data masuk dari serekan. Struktur ini diisi jika peristiwa PEER_GROUP_EVENT_INCOMING_DATA dinaikkan.

recordChangeData

Menentukan struktur PEER_EVENT_RECORD_CHANGE_DATA yang berisi data yang menjelaskan perubahan rekaman. Struktur ini diisi jika peristiwa PEER_GROUP_EVENT_RECORD_CHANGED dinaikkan.

connectionChangeData

PEER_EVENT_CONNECTION_CHANGE_DATA struktur yang berisi informasi ketika koneksi langsung atau tetangga telah berubah. Struktur ini diisi jika peristiwa PEER_GROUP_EVENT_DIRECT_CONNECTION atau PEER_GROUP_EVENT_NEIGHBOR_CONNECTION dinaikkan.

memberChangeData

PEER_EVENT_MEMBER_CHANGE_DATA struktur yang berisi data saat status anggota grup serekan berubah. Struktur ini diisi jika peristiwa PEER_GROUP_EVENT_MEMBER_CHANGED dinaikkan.

hrConnectionFailedReason

HRESULT yang menunjukkan jenis kegagalan koneksi yang terjadi. Nilai ini diisi jika peristiwa PEER_GROUP_EVENT_CONNECTION_FAILED dinaikkan. Nilai ini adalah salah satu dari berikut ini:

Nilai	Makna
PEER_E_NO_MEMBERS_FOUND	Tidak ada rekan yang tersedia dalam grup serekan yang ditemukan untuk disambungkan.
PEER_E_NO_MEMBER_CONNECTIONS	Tidak ada koneksi anggota yang tersedia.
PEER_E_UNABLE_TO_LISTEN	Serekan tidak dapat menerima data koneksi karena alasan yang tidak ditentukan.
PEER_E_NOT_AUTHORIZED	Upaya telah dilakukan untuk melakukan operasi yang tidak sah. Misalnya, mencoba bergabung dengan grup dengan kata sandi yang tidak valid.