PeerGroupEnumMembers, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGroupEnumMembers crée une énumération des membres du groupe d’homologues disponibles et les informations d’appartenance associées.

Syntaxe

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

Paramètres

[in] hGroup

Gérez le groupe d’homologues dont les membres sont énumérés. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] dwFlags

Spécifie les indicateurs PEER_MEMBER_FLAGS qui indiquent les types de membres à inclure dans l’énumération. Si cette valeur est définie sur zéro, tous les membres du groupe d’homologues sont inclus.

Valeur	Signification
PEER_MEMBER_PRESENT	Énumérez tous les membres du groupe d’homologues actuel qui sont en ligne.

[in] pwzIdentity

Chaîne Unicode qui contient l’identité d’un homologue spécifique dont les informations sont récupérées et retournées dans une énumération à un élément. Si ce paramètre a la valeur NULL, tous les membres du groupe d’homologues actuel sont récupérés. Ce paramètre est obligatoire.

[out] phPeerEnum

Pointeur vers l’énumération qui contient la liste retournée des membres du groupe d’homologues. Ce handle est passé à
PeerGetNextItem pour récupérer les éléments, chaque élément étant représenté sous la forme d’un pointeur vers une structure PEER_MEMBER . Lorsque vous avez terminé, PeerEndEnumeration est appelé pour retourner la mémoire utilisée par l’énumération. Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_INVALID_GROUP	Le handle du groupe d’homologues n’est pas valide.

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont préfixées par CRYPT_* et définies dans Winerror.h.

Remarques

Le nœud local est toujours le tout premier élément de l’énumération si pwzIdentity a la valeur NULL et dwFlags est défini pour indiquer que le nœud local est membre du sous-ensemble explicite.

Par défaut, chaque membre publie des informations d’appartenance au groupe d’homologues. Si PEER_MEMBER_DATA_OPTIONAL est défini sur les données PEER_MEMBER pour cet homologue, ces informations sont disponibles uniquement lorsqu’un homologue effectue une action au sein du groupe, par exemple, la publication d’un enregistrement, la mise à jour de la présence ou l’émission d’une console GMC.

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

Voir aussi

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem

Partager via