Fungsi PeerGroupEnumMembers (p2p.h)

Artikel
03/01/2024

Fungsi PeerGroupEnumMembers membuat enumerasi anggota grup serekan yang tersedia dan informasi keanggotaan terkait.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumMembers(
  [in]  HGROUP    hGroup,
  [in]  DWORD     dwFlags,
  [in]  PCWSTR    pwzIdentity,
  [out] HPEERENUM *phPeerEnum
);

Parameter

[in] hGroup

Tangani ke grup serekan yang anggotanya dijumlahkan. Handel ini dikembalikan oleh fungsi PeerGroupCreate, PeerGroupOpen, atau PeerGroupJoin . Parameter ini diperlukan.

[in] dwFlags

Menentukan bendera PEER_MEMBER_FLAGS yang menunjukkan jenis anggota mana yang akan disertakan dalam enumerasi. Jika nilai ini diatur ke nol, semua anggota grup serekan disertakan.

Nilai	Makna
PEER_MEMBER_PRESENT	Hitung semua anggota grup serekan saat ini yang sedang online.

[in] pwzIdentity

Untai (karakter) Unicode yang berisi identitas serekan tertentu yang informasinya diambil dan dikembalikan dalam enumerasi satu item. Jika parameter ini NULL, semua anggota grup serekan saat ini diambil. Parameter ini diperlukan.

[out] phPeerEnum

Arahkan ke enumerasi yang berisi daftar anggota grup serekan yang dikembalikan. Handel ini diteruskan ke
PeerGetNextItem untuk mengambil item, dengan setiap item direpresentasikan sebagai penunjuk ke struktur PEER_MEMBER . Setelah selesai, PeerEndEnumeration dipanggil untuk mengembalikan memori yang digunakan oleh enumerasi. Parameter ini diperlukan.

Mengembalikan nilai

Mengembalikan S_OK jika operasi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_INVALID_GROUP	Handel ke grup serekan tidak valid.

Kesalahan khusus kriptografi dapat dikembalikan dari Penyedia Dasar Microsoft RSA. Kesalahan ini diawali dengan CRYPT_* dan didefinisikan dalam Winerror.h.

Keterangan

Simpul lokal selalu merupakan item pertama dalam enumerasi jika pwzIdentity adalah NULL, dan dwFlags diatur untuk menunjukkan bahwa simpul lokal adalah anggota subset eksplisit.

Secara default, setiap anggota menerbitkan informasi keanggotaan ke grup serekan. Jika PEER_MEMBER_DATA_OPTIONAL diatur pada data PEER_MEMBER untuk rekan tersebut, informasi ini hanya tersedia saat serekan melakukan tindakan dalam grup, misalnya, menerbitkan rekaman, memperbarui kehadiran, atau mengeluarkan GMC.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Advanced Networking Pack forWindows XP
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	p2p.h
Pustaka	P2P.lib
DLL	P2P.dll

Lihat juga

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem

Bagikan melalui