PeerGroupParseInvitation function (p2p.h)

The PeerGroupParseInvitation function returns a PEER_INVITATION_INFO structure with the details of a specific invitation.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupParseInvitation(
  [in]  PCWSTR                pwzInvitation,
  [out] PPEER_INVITATION_INFO *ppInvitationInfo
);

Parameters

[in] pwzInvitation

Pointer to a Unicode string that contains the specific peer group invitation. This parameter is required.

[out] ppInvitationInfo

Pointer to a PEER_INVITATION_INFO structure with the details of a specific invitation. To release the resources used by this structure, pass this pointer to PeerFreeData. This parameter is required.

Return value

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

Return code Description
E_INVALIDARG
One of the parameters is not valid.
E_OUTOFMEMORY
There is not enough memory available to complete an operation.
PEER_E_INVITATION_NOT_TRUSTED
The invitation is not trusted by the peer. It has been altered or contains errors.
PEER_E_UNSUPPORTED_VERSION
The invitation is not supported by the current version of the Peer Infrastructure.
 

Cryptography-specific errors can be returned from the Microsoft RSA Base Provider. These errors are prefixed with CRYPT_* and defined in Winerror.h.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack forWindows XP
Minimum supported server None supported
Target Platform Windows
Header p2p.h
Library P2P.lib
DLL P2P.dll

See also

PEER_INVITATION_INFO

PeerGroupCreateInvitation