structure PEER_INVITATION_INFO (p2p.h)

Article
08/25/2023

La structure PEER_INVITATION_INFO définit des informations sur une invitation à rejoindre un groupe d’homologues. Les invitations sont représentées sous forme de chaînes Unicode. Pour obtenir cette structure, transmettez la chaîne d’invitation XML créée par PeerGroupCreateInvitation à PeerGroupParseInvitation.

Syntaxe

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;

Membres

dwSize

Spécifie la taille de cette structure, en octets.

dwFlags

Doit être défini sur 0x00000000.

pwzCloudName

Pointeur vers une chaîne Unicode qui spécifie le nom du cloud PNRP.

dwScope

Spécifie l’étendue sous laquelle le groupe d’homologues a été inscrit.

Valeur	Signification
PNRP_GLOBAL_SCOPE	Étendue globale, y compris Internet.
PNRP_LOCAL_SCOPE	Étendue locale.
PNRP_LINK_LOCAL_SCOPE	Étendue locale du lien.

dwCloudFlags

Spécifie un ensemble d’indicateurs qui décrivent les fonctionnalités du cloud PNRP.

Valeur	Signification
PNRP_CLOUD_NO_FLAGS 0	Aucun indicateur n'est défini.
PNRP_CLOUD_NAME_LOCAL 1	Le nom du cloud n’est pas disponible sur d’autres ordinateurs ; il est défini localement.

pwzGroupPeerName

Pointeur vers une chaîne Unicode qui spécifie le nom d’homologue du groupe d’homologues.

pwzIssuerPeerName

Pointeur vers une chaîne Unicode qui spécifie le nom PNRP de l’homologue qui émet l’invitation.

pwzSubjectPeerName

Pointeur vers une chaîne Unicode qui spécifie le nom PNRP de l’homologue qui reçoit l’invitation.

pwzGroupFriendlyName

Pointeur vers une chaîne Unicode qui spécifie le nom convivial (d’affichage) du groupe d’homologues.

pwzIssuerFriendlyName

Pointeur vers une chaîne Unicode qui spécifie le nom convivial (d’affichage) de l’homologue qui émet l’invitation.

pwzSubjectFriendlyName

Pointeur vers une chaîne Unicode qui spécifie le nom convivial (d’affichage) de l’homologue qui reçoit l’invitation.

ftValidityStart

Spécifie une valeur UTC FILETIME qui indique quand l’invitation devient valide.

ftValidityEnd

Spécifie une valeur UTC FILETIME qui indique quand l’invitation devient non valide.

cRoles

Spécifie le nombre d’GUID de rôle présents dans pRoles.

pRoles

Pointeur vers une liste de GUID qui spécifie l’ensemble combiné de rôles disponibles. Les rôles disponibles sont les suivants.

Valeur	Signification
PEER_GROUP_ROLE_ADMIN	Ce rôle peut émettre des invitations, renouveler des appartenances, modifier les propriétés de groupe d’homologues, publier et mettre à jour des enregistrements et renouveler la console GMC d’autres administrateurs.
PEER_GROUP_ROLE_MEMBER	Le rôle peut publier des enregistrements dans la base de données du groupe d’homologues.

cClassifiers

Valeur entière non signée qui contient le nombre de valeurs de chaîne répertoriées dans ppwzClassifiers. Ce champ est réservé à une utilisation ultérieure.

ppwzClassifiers

Liste des pointeurs vers des chaînes Unicode. Ce champ est réservé à une utilisation ultérieure.

pSubjectPublicKey

Pointeur vers une structure de CERT_PUBLIC_KEY_INFO qui contient la clé publique retournée du destinataire et le type d’algorithme de chiffrement qu’il utilise.

authScheme

Windows Vista ou version ultérieure. Le PEER_GROUP_AUTHENTICATION_SCHEME valeur d’énumération qui indique le type d’authentification utilisé pour valider l’invité de groupe d’homologues.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows XP
Serveur minimal pris en charge	Aucun pris en charge
En-tête	p2p.h

Voir aussi

PeerGroupParseInvitation

Partager via