PeerEnumIdentities, fonction (p2p.h)
La fonction PeerEnumIdentities crée et retourne un handle d’énumération d’homologue utilisé pour énumérer toutes les identités homologues qui appartiennent à un utilisateur spécifique.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
[out] HPEERENUM *phPeerEnum
);
Paramètres
[out] phPeerEnum
Reçoit un handle pour l’énumération d’homologue qui contient la liste des identités homologues, avec chaque élément représenté sous la forme d’un pointeur vers une structure PEER_NAME_PAIR . Passez ce handle à PeerGetNextItem pour récupérer les éléments ; Lorsque vous avez terminé, appelez PeerEndEnumeration pour libérer la mémoire.
Valeur retournée
Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, elle 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. |
Remarques
Une fois que l’application a obtenu le handle d’énumération d’homologue, utilisez PeerGetNextItem et PeerGetItemCount pour énumérer les identités homologues.
Lors de l’énumération des identités homologues, PeerGetNextItem retourne un tableau de pointeurs vers PEER_NAME_PAIR structures.
Appelez PeerEndEnumeration pour libérer le handle d’énumération 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 |