PeerCollabEnumEndpoints, fonction (p2p.h)
La fonction PeerCollabEnumEndpoints retourne le handle à une énumération qui contient les points de terminaison associés à un contact d’homologue spécifique.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumEndpoints(
[in] PCPEER_CONTACT pcContact,
[out] HPEERENUM *phPeerEnum
);
Paramètres
[in] pcContact
Pointeur vers une structure PEER_CONTACT qui contient les informations de contact d’un homologue spécifique. Ce paramètre ne doit pas avoir la valeur NULL.
[out] phPeerEnum
Pointeur vers un handle pour l’ensemble énuméré de points de terminaison associés au contact d’homologue fourni. Passez ce handle à PeerGetNextItem pour obtenir chaque élément du jeu énuméré.
Valeur retournée
Retourne S_OK si la fonction réussit. Sinon, la fonction retourne l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
La mémoire est insuffisante pour prendre en charge cette opération. |
|
L’un des arguments n’est pas valide. |
|
L’infrastructure d’homologue Windows n’est pas initialisée. L’appel de la fonction d’initialisation appropriée est obligatoire. |
|
L’opération nécessite que l’utilisateur soit connecté. |
Remarques
Il est recommandé de mettre à jour un enregistrement de contact à l’aide de PeerCollabUpdateContact avant d’appeler PeerCollabEnumEndpoints. Si vous ne le faites pas, vous pouvez retourner E_INVALIDARG.
Les points de terminaison seront disponibles uniquement pour les contacts avec fWatch défini sur true. Seuls les points de terminaison qui ont le contact « Moi » de l’homologue appelant enregistré en tant que contact approuvé et dont WatcherPermissions est défini sur autoriser seront disponibles. Un contact doit également être connecté à Internet. Si le contact n’est pas connecté, l’erreur E_INVALIDARG est retournée.
Pour obtenir les points de terminaison d’homologue individuels, passez le handle retourné à PeerGetNextItem. Un tableau de pointeurs vers PEER_ENDPOINT structures sera retourné. Si aucun point de terminaison n’est disponible, un tableau vide est retourné. Pour fermer l’énumération et libérer les ressources qui lui sont associées, passez ce handle à PeerEndEnumeration. Les éléments individuels retournés par l’énumération doivent être libérés avec PeerFreeData.
La limite pour les connexions à un seul contact est de 50.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | p2p.h |
| Bibliothèque | P2P.lib |
| DLL | P2P.dll |