PeerCollabQueryContactData, fonction (p2p.h)
La fonction PeerCollabQueryContactData récupère les informations de contact pour le point de terminaison d’homologue fourni.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
[in, optional] PCPEER_ENDPOINT pcEndpoint,
[out] PWSTR *ppwzContactData
);
Paramètres
[in, optional] pcEndpoint
Pointeur vers une structure PEER_ENDPOINT qui contient le point de terminaison d’homologue sur lequel obtenir des informations de contact.
Si ce paramètre est défini sur NULL, les informations de contact du point de terminaison d’homologue actuel sont obtenues.
[out] ppwzContactData
Pointeur vers une mémoire tampon de chaîne Unicode à terminaison zéro qui contient les données de contact pour le point de terminaison fourni dans pcEndpoint. Appelez PeerFreeData pour libérer les données.
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. |
|
Les données de contact demandées n’existent pas. Essayez d’appeler PeerCollabRefreshEndpointData avant d’effectuer une autre tentative. |
Remarques
Pour récupérer correctement les données de contact d’un point de terminaison, 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.
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 |