PEER_INVITATION_INFO structure (p2p.h)

The PEER_INVITATION_INFO structure defines information about an invitation to join a peer group. Invitations are represented as Unicode strings. To obtain this structure, pass the XML invitation string created by PeerGroupCreateInvitation to PeerGroupParseInvitation.

Syntax

typedef struct peer_invitation_info_tag {
  DWORD                            dwSize;
  DWORD                            dwFlags;
  PWSTR                            pwzCloudName;
  DWORD                            dwScope;
  DWORD                            dwCloudFlags;
  PWSTR                            pwzGroupPeerName;
  PWSTR                            pwzIssuerPeerName;
  PWSTR                            pwzSubjectPeerName;
  PWSTR                            pwzGroupFriendlyName;
  PWSTR                            pwzIssuerFriendlyName;
  PWSTR                            pwzSubjectFriendlyName;
  FILETIME                         ftValidityStart;
  FILETIME                         ftValidityEnd;
  ULONG                            cRoles;
  PEER_ROLE_ID                     *pRoles;
  ULONG                            cClassifiers;
  PWSTR                            *ppwzClassifiers;
  CERT_PUBLIC_KEY_INFO             *pSubjectPublicKey;
  PEER_GROUP_AUTHENTICATION_SCHEME authScheme;
} PEER_INVITATION_INFO, *PPEER_INVITATION_INFO;

Members

dwSize

Specifies the size of this structure, in bytes.

dwFlags

Must be set to 0x00000000.

pwzCloudName

Pointer to a Unicode string that specifies the PNRP cloud name.

dwScope

Specifies the scope under which the peer group was registered.

dwCloudFlags

Specifies a set of flags that describe PNRP cloud features.

pwzGroupPeerName

Pointer to a Unicode string that specifies the peer name of the peer group.

pwzIssuerPeerName

Pointer to a Unicode string that specifies the PNRP name of the peer issuing the invitation.

pwzSubjectPeerName

Pointer to a Unicode string that specifies the PNRP name of the peer that receives the invitation.

pwzGroupFriendlyName

Pointer to a Unicode string that specifies the friendly (display) name of the peer group.

pwzIssuerFriendlyName

Pointer to a Unicode string that specifies the friendly (display) name of the peer issuing the invitation.

pwzSubjectFriendlyName

Pointer to a Unicode string that specifies the friendly (display) name of the peer that receives the invitation.

ftValidityStart

Specifies a UTC FILETIME value that indicates when the invitation becomes valid.

ftValidityEnd

Specifies a UTC FILETIME value that indicates when the invitation becomes invalid.

cRoles

Specifies the number of role GUIDs present in pRoles.

pRoles

Pointer to a list of GUIDs that specifies the combined set of available roles. The available roles are as follows.

cClassifiers

Unsigned integer value that contains the number of string values listed in ppwzClassifiers. This field is reserved for future use.

ppwzClassifiers

List of pointers to Unicode strings. This field is reserved for future use.

pSubjectPublicKey

Pointer to a CERT_PUBLIC_KEY_INFO structure that contains the recipient's returned public key and the encryption algorithm type it uses.

authScheme

Windows Vista or later. The PEER_GROUP_AUTHENTICATION_SCHEME enumeration value that indicates the type of authentication used to validate the peer group invitee.

Requirements

See also

PeerGroupParseInvitation