PeerCollabEnumApplications, fonction (p2p.h)
La fonction PeerCollabEnumApplications retourne le handle à une énumération qui contient les applications inscrites auprès des points de terminaison d’un homologue spécifique.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplications(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[in, optional] const GUID *pApplicationId,
[out] HPEERENUM *phPeerEnum
);
Paramètres
[in, optional] pcEndpoint
Pointeur vers une structure PEER_ENDPOINT qui contient les informations de point de terminaison d’un homologue dont les applications seront énumérées.
Si ce paramètre est défini sur NULL, les informations d’application publiées pour le point de terminaison de l’homologue local sont énumérées.
[in, optional] pApplicationId
Pointeur vers la valeur GUID qui identifie de manière unique une application particulière de l’homologue fourni. Si ce paramètre est fourni, la seule application homologue retournée est celle qui correspond à ce GUID.
[out] phPeerEnum
Pointeur vers le handle pour l’ensemble énuméré d’applications inscrites qui correspondent au GUID retourné dans pObjectId. 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 homologue Windows n’est pas initialisée. L’appel de la fonction d’initialisation appropriée est obligatoire. |
Notes
Pour pouvoir énumérer correctement les applications pour le point de terminaison spécifié, les données d’application doivent être disponibles sur le point de terminaison. Pour que les données d’application soient disponibles, l’une des opérations suivantes doit se produire :
- Le point de terminaison doit avoir été obtenu précédemment en appelant PeerCollabEnumEndpoints.
- L’homologue local doit s’être abonné au point de terminaison en appelant PeerCollabSubscribeEndpointData.
- Les données de point de terminaison doivent être actualisées en appelant PeerCollabRefreshEndpointData avec succès.
Pour obtenir les applications homologues individuelles, passez le handle retourné à PeerGetNextItem. Pour fermer l’énumération et libérer les ressources qui lui sont associées, transmettez ce handle à PeerEndEnumeration. Les éléments individuels retournés par l’énumération doivent être libérés avec PeerFreeData.
Les éléments de données d’application homologue sont retournés en tant que structures PEER_APPLICATION individuelles.
La fonction PeerCollabEnumApplications retourne un tableau vide pour les points de terminaison sur le sous-réseau qui ne sont pas des contacts approuvés.
Spécifications
| 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 |