PeerCollabSubscribeEndpointData, fonction (p2p.h)
La fonction PeerCollabSubscribeEndpointData crée un abonnement à un point de terminaison disponible.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSubscribeEndpointData(
[in] const PCPEER_ENDPOINT pcEndpoint
);
Paramètres
[in] pcEndpoint
Pointeur vers une structure PEER_ENDPOINT qui contient le point de terminaison d’homologue utilisé pour obtenir des informations de présence.
Valeur retournée
Retourne S_OK ou PEER_S_SUBSCRIPTION_EXISTS 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. |
Remarques
PeerCollabSubscribeEndpointData est un appel asynchrone, ce qui signifie que le processus d’abonnement au point de terminaison a été démarré mais pas nécessairement terminé lorsque cet appel est retourné. Une application doit attendre PEER_EVENT_REQUEST_STATUS_CHANGED pour obtenir le résultat de la demande d’abonnement.
Cette fonction expire à 30 secondes.
PeerCollabSubscribeEndpointData peut être appelé plusieurs fois à partir d’applications différentes pour le même point de terminaison. Chaque appel est comptabilisé en référence ; uniquement lorsque la dernière référence est publiée est un homologue désinscrit. Pour libérer la référence, appelez PeerCollabUnsubscribeEndpointData.
Lorsqu’une application se ferme sans appeler PeerCollabUnsubscribeEndpointData, toutes les références pour cette application sont publiées automatiquement.
Pour appeler correctement les API PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects et PeerCollabQueryContactData , une application doit d’abord appeler PeerCollabSubscribeEndpointData.
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 |