Funzione PeerCollabExportContact (p2p.h)

La funzione PeerCollabExportContact esporta i dati di contatto associati a un nome peer in un buffer di stringa. Il buffer contiene i dati di contatto in formato XML.

La funzione PeerCollabAddContact consente l'utilizzo di questa stringa XML da parte di altri peer.

Sintassi

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

Parametri

[in, optional] pwzPeerName

Puntatore a stringa Unicode con terminazione zero contenente il nome del contatto peer per cui esportare.

Se questo parametro è NULL, le informazioni di contatto "Me" per il peer chiamante vengono esportate.

[out, optional] ppwzContactData

Puntatore a un buffer stringa con terminazione zero che contiene dati XML di contatto peer in cui i nomi peer corrispondono alla stringa fornita in pwzPeerName.

La memoria restituita qui può essere liberata chiamando PeerFreeData.

Valore restituito

Restituisce S_OK se la funzione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente per supportare questa operazione.
E_INVALIDARG	Uno degli argomenti non è valido.
PEER_E_NOT_INITIALIZED	L'infrastruttura peer di Windows non viene inizializzata. È necessario chiamare la funzione di inizializzazione pertinente.
PEER_E_NOT_SIGNED_IN	Uno degli argomenti non è valido.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll

Vedi anche

Funzioni API di collaborazione peer