Funzione PeerCollabAddContact (p2p.h)
La funzione PeerCollabAddContact aggiunge un contatto all'elenco contatti di un peer.
Sintassi
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAddContact(
[in] PCWSTR pwzContactData,
[out, optional] PPEER_CONTACT *ppContact
);
Parametri
[in] pwzContactData
Puntatore a un buffer di stringhe Unicode con terminazione zero che contiene i dati di contatto per il peer aggiunto all'elenco contatti. Questo buffer di stringhe può essere ottenuto passando il nome peer dell'endpoint da aggiungere come contatto a PeerCollabQueryContactData o tramite un meccanismo fuori banda.
Per inviare i propri dati di contatto fuori banda, il peer può chiamare PeerCollabExportContact con un nome peer NULL . Questa funzione restituisce i dati di contatto in formato XML.
[out, optional] ppContact
Puntatore a un puntatore a una struttura PEER_CONTACT . Questo parametro riceve l'indirizzo di una struttura di PEER_CONTACT contenente le informazioni di contatto peer per il contatto fornito in pwzContactData. Questo parametro può essere NULL.
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 |
|---|---|
|
Memoria insufficiente per supportare questa operazione. |
|
Uno degli argomenti non è valido. |
Requisiti
| 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 |