Edit

PeerCollabParseContact function (p2p.h)

  • Article

The PeerCollabParseContact function parses a Unicode string buffer containing contact XML data into a PEER_CONTACT data structure.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabParseContact(
  [in]  PCWSTR        pwzContactData,
  [out] PPEER_CONTACT *ppContact
);

Parameters

[in] pwzContactData

Pointer to zero-terminated Unicode string buffer that contains XML contact data as returned by functions like PeerCollabQueryContactData or PeerCollabExportContact.

[out] ppContact

Pointer to the address of a PEER_CONTACT structure that contain the peer contact information parsed from pwzContactData. Free the memory allocated by calling PeerFreeData.

Return value

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.
PEER_E_NOT_INITIALIZED
 The Windows Peer infrastructure is not initialized. Calling the relevant initialization function is required.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header p2p.h
Library P2P.lib
DLL P2P.dll

See also

PEER_CONTACT

Peer Collaboration API Functions