Funzione PeerCollabGetContact (p2p.h)

La funzione PeerCollabGetContact ottiene le informazioni per un contatto peer dato il nome peer del contatto.

Sintassi

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

Parametri

[in, optional] pwzPeerName

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

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

[out, optional] ppContact

Puntatore a un puntatore a una struttura PEER_CONTACT . Riceve l'indirizzo di una struttura PEER_CONTACT contenente le informazioni di contatto peer per il nome del peer fornito in pwzPeerName. Quando questo parametro è NULL, questa funzione restituisce E_INVALIDARG.

Chiamare PeerFreeData sull'indirizzo della struttura PEER_CONTACT per liberare questi dati.

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.

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

PEER_CONTACT

Funzioni API di collaborazione peer