Fungsi PeerEnumGroups (p2p.h)
Fungsi PeerEnumGroups membuat dan mengembalikan handel enumerasi serekan yang digunakan untuk menghitung semua grup serekan yang terkait dengan identitas serekan tertentu.
Sintaks
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
[in] PCWSTR pwzIdentity,
[out] HPEERENUM *phPeerEnum
);
Parameter
[in] pwzIdentity
Menentukan identitas serekan untuk menghitung grup.
[out] phPeerEnum
Menerima handel ke enumerasi serekan yang berisi daftar grup serekan tempat identitas yang ditentukan adalah anggotanya, dengan setiap item diwakili sebagai penunjuk ke struktur PEER_NAME_PAIR . Teruskan handel ini ke PeerGetNextItem untuk mengambil item; setelah selesai, panggil PeerEndEnumeration rilis memori.
Nilai kembali
Jika panggilan fungsi berhasil, nilai yang dikembalikan adalah S_OK. Jika tidak, ia mengembalikan salah satu nilai berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Salah satu parameter tidak valid. |
|
Memori tidak cukup untuk melakukan operasi yang ditentukan. |
|
Identitas serekan yang ditentukan tidak dapat ditemukan. |
Keterangan
Setelah aplikasi mendapatkan handel enumerasi, gunakan PeerGetNextItem dan PeerGetItemCount untuk menghitung grup serekan.
Saat menghitung grup serekan, PeerGetNextItem mengembalikan array pointer ke struktur PEER_NAME_PAIR .
Panggil PeerEndEnumeration untuk membebaskan handel enumerasi serekan ketika tidak lagi diperlukan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Paket Jaringan Tingkat Lanjut untuk Windows XP |
| Server minimum yang didukung | Tidak ada yang didukung |
| Target Platform | Windows |
| Header | p2p.h |
| Pustaka | P2P.lib |
| DLL | P2P.dll |