PeerCollabAddContact, fonction (p2p.h)
La fonction PeerCollabAddContact ajoute un contact à la liste de contacts d’un homologue.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAddContact(
[in] PCWSTR pwzContactData,
[out, optional] PPEER_CONTACT *ppContact
);
Paramètres
[in] pwzContactData
Pointeur vers une mémoire tampon de chaîne Unicode sans fin qui contient les données de contact de l’homologue ajouté à la liste de contacts. Cette mémoire tampon de chaîne peut être obtenue en passant le nom d’homologue du point de terminaison à ajouter en tant que contact à PeerCollabQueryContactData, ou via un mécanisme hors bande.
Pour envoyer ses propres données de contact hors bande, l’homologue peut appeler PeerCollabExportContact avec un nom d’homologue NULL . Cette fonction retourne les données de contact au format XML.
[out, optional] ppContact
Pointeur vers un pointeur vers une structure PEER_CONTACT . Ce paramètre reçoit l’adresse d’une structure de PEER_CONTACT contenant les informations de contact des homologues pour le contact fourni dans pwzContactData. Ce paramètre peut avoir la valeur NULL.
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 |
|---|---|
|
La mémoire est insuffisante pour prendre en charge cette opération. |
|
L’un des arguments n’est pas valide. |
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 |