PeerEnumGroups, fonction (p2p.h)
La fonction PeerEnumGroups crée et retourne un handle d’énumération d’homologue utilisé pour énumérer tous les groupes d’homologues associés à une identité d’homologue spécifique.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
[in] PCWSTR pwzIdentity,
[out] HPEERENUM *phPeerEnum
);
Paramètres
[in] pwzIdentity
Spécifie l’identité d’homologue pour laquelle énumérer les groupes.
[out] phPeerEnum
Reçoit un handle pour l’énumération d’homologues qui contient la liste des groupes d’homologues dont l’identité spécifiée est membre, chaque élément étant représenté comme pointeur vers une structure PEER_NAME_PAIR . Passez ce handle à PeerGetNextItem pour récupérer les éléments ; lorsque vous avez terminé, appelez PeerEndEnumeration libérer la mémoire.
Valeur retournée
Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
La mémoire est insuffisante pour effectuer l’opération spécifiée. |
|
L’identité d’homologue spécifiée est introuvable. |
Remarques
Une fois que l’application a obtenu le handle d’énumération, utilisez PeerGetNextItem et PeerGetItemCount pour énumérer les groupes d’homologues.
Lors de l’énumération de groupes d’homologues, PeerGetNextItem retourne un tableau de pointeurs vers PEER_NAME_PAIR structures.
Appelez PeerEndEnumeration pour libérer le handle d’énumération d’homologue lorsqu’il n’est plus nécessaire.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack de mise en réseau avancé pour Windows XP |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | p2p.h |
| Bibliothèque | P2P.lib |
| DLL | P2P.dll |