PeerCollabGetContact, fonction (p2p.h)

Article
03/06/2024

La fonction PeerCollabGetContact obtient les informations d’un contact homologue en fonction du nom d’homologue du contact.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetContact(
  [in, optional]  PCWSTR        pwzPeerName,
  [out, optional] PPEER_CONTACT *ppContact
);

Paramètres

[in, optional] pwzPeerName

Pointeur vers une chaîne Unicode terminée sans fin qui contient le nom du contact homologue pour lequel obtenir des informations.

Si ce paramètre a la valeur NULL, les informations de contact « Moi » pour l’homologue appelant sont retournées.

[out, optional] ppContact

Pointeur vers un pointeur vers une structure PEER_CONTACT . Il reçoit l’adresse d’une structure de PEER_CONTACT contenant les informations de contact d’homologue pour le nom d’homologue fourni dans pwzPeerName. Lorsque ce paramètre a la valeur NULL, cette fonction retourne E_INVALIDARG.

Appelez PeerFreeData sur l’adresse de la structure PEER_CONTACT pour libérer ces 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
E_OUTOFMEMORY	La mémoire est insuffisante pour prendre en charge cette opération.
E_INVALIDARG	L’un des arguments n’est pas valide.
PEER_E_NOT_INITIALIZED	L’infrastructure homologue Windows n’est pas initialisée. L’appel de la fonction d’initialisation appropriée est obligatoire.

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

Voir aussi

PEER_CONTACT

Fonctions de l’API De collaboration entre pairs

Partager via