nf-p2p-peercollabaddcontact.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:p2p.PeerCollabAddContact	PeerCollabAddContact function (p2p.h)	Adds a contact to the contact list of a peer.	PeerCollabAddContact PeerCollabAddContact function [Peer Networking] p2p.peercollabaddcontact p2p/PeerCollabAddContact	p2p\peercollabaddcontact.htm	p2p	0e4ba039-2016-487d-b4df-e96648db1a05	12/05/2018	PeerCollabAddContact, PeerCollabAddContact function [Peer Networking], p2p.peercollabaddcontact, p2p/PeerCollabAddContact	p2p.h		Windows	Windows Vista [desktop apps only]	None supported										P2P.lib	P2P.dll		Windows			19H1	PeerCollabAddContact p2p/PeerCollabAddContact	c++	APIRef kbSyntax	DllExport	P2P.dll	PeerCollabAddContact

PeerCollabAddContact function

-description

The PeerCollabAddContact function adds a contact to the contact list of a peer.

-parameters

-param pwzContactData [in]

Pointer to a zero-terminated Unicode string buffer that contains the contact data for the peer that is added to the contact list. This string buffer can either be obtained by passing the peer name of the endpoint to add as a contact to PeerCollabQueryContactData, or through an out-of-band mechanism.

To send its own contact data out-of-band, the peer can call PeerCollabExportContact with a NULL peer name. This function returns the contact data in XML format.

-param ppContact [out, optional]

Pointer to a pointer to a PEER_CONTACT structure. This parameter receives the address of a PEER_CONTACT structure containing peer contact information for the contact supplied in pwzContactData. This parameter may be NULL.

Call PeerFreeData on the address of the PEER_CONTACT structure to free this data.

-returns

Returns S_OK if the function succeeds. Otherwise, the function returns one of the following values.

Return code	Description
E_OUTOFMEMORY	There is not enough memory to support this operation.
E_INVALIDARG	One of the arguments is invalid.

-see-also

PEER_CONTACT

Peer Collaboration API Functions

PeerCollabExportContact

PeerCollabQueryContactData