Partager via


PeerCollabExportContact, fonction (p2p.h)

La fonction PeerCollabExportContact exporte les données de contact associées à un nom d’homologue vers une mémoire tampon de chaîne. La mémoire tampon contient des données de contact au format XML.

La fonction PeerCollabAddContact permet à cette chaîne XML d’être utilisée par d’autres homologues.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabExportContact(
  [in, optional]  PCWSTR pwzPeerName,
  [out, optional] PWSTR  *ppwzContactData
);

Paramètres

[in, optional] pwzPeerName

Pointeur vers une chaîne Unicode sans fin qui contient le nom du contact d’homologue pour lequel exporter.

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

[out, optional] ppwzContactData

Pointeur vers une mémoire tampon de chaîne sans fin qui contient des données XML de contact d’homologue où les noms d’homologues correspondent à la chaîne fournie dans pwzPeerName.

La mémoire retournée ici peut être libérée en appelant PeerFreeData.

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 d’homologue Windows n’est pas initialisée. L’appel de la fonction d’initialisation appropriée est obligatoire.
PEER_E_NOT_SIGNED_IN
L’un des arguments n’est pas valide.

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

Fonctions de l’API De collaboration d’homologue