PeerGroupCreateInvitation, fonction (p2p.h)

Article
08/25/2023

La fonction PeerGroupCreateInvitation retourne une chaîne XML qui peut être utilisée par l’homologue spécifié pour joindre un groupe.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreateInvitation(
  [in]  HGROUP     hGroup,
  [in]  PCWSTR     pwzIdentityInfo,
  [in]  FILETIME   *pftExpiration,
  [in]  ULONG      cRoles,
  [in]  const GUID *pRoles,
  [out] PWSTR      *ppwzInvitation
);

Paramètres

[in] hGroup

Gérez le groupe d’homologues pour lequel cette invitation est émise. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pwzIdentityInfo

Pointeur vers une chaîne Unicode qui contient l’objet blob XML (y compris la console GMC) retourné par un appel précédent à PeerIdentityGetXML avec l’identité de l’homologue. Ce paramètre peut également contenir un pointeur vers un objet blob XML généré par PeerIdentityGetXML à l’aide des informations d’homologue contenues dans PEER_CONTACT pour générer une invitation pour un contact d’homologue.

[in] pftExpiration

Spécifie une structure UTC FILETIME qui contient la date et l’heure spécifiques d’expiration de l’invitation. Cette valeur ne peut pas être supérieure à la durée de vie restante de l’homologue émetteur. Si ce paramètre a la valeur NULL, la durée de vie de l’invitation est définie sur la valeur maximale possible, c’est-à-dire la durée de vie restante de l’homologue.

[in] cRoles

Spécifie le nombre de rôles dans pRoleInfo.

[in] pRoles

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

Valeur	Signification
PEER_GROUP_ROLE_ADMIN	Ce rôle peut émettre des invitations, émettre des informations d’identification et renouveler la console GMC d’autres administrateurs, ainsi que se comporter en tant que membre du groupe d’homologues.
PEER_GROUP_ROLE_MEMBER	Ce rôle peut publier des enregistrements dans la base de données de groupe.

[out] ppwzInvitation

Pointeur vers une chaîne Unicode qui contient l’invitation de l’émetteur. Cette invitation peut être passée à PeerGroupJoin par le destinataire afin de rejoindre le groupe d’homologues spécifié. Pour retourner les détails de l’invitation en tant que structure PEER_INVITATION_INFO , transmettez cette chaîne à PeerGroupParseInvitation. Pour libérer ces données, transmettez ce pointeur à PeerFreeData.

Valeur retournée

Retourne S_OK si l’opération réussit ; sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_GROUP_NOT_READY	Le groupe d’homologues n’est pas dans un état où des enregistrements peuvent être ajoutés. Par exemple, PeerGroupJoin est appelé, mais la synchronisation avec la base de données de groupe n’est pas terminée.
PEER_E_CHAIN_TOO_LONG	La chaîne GMC est plus longue que 24 administrateurs ou membres. Pour plus d’informations sur les chaînes GMC, reportez-vous à la documentation Fonctionnement de la sécurité de groupe .
PEER_E_IDENTITY_DELETED	Les données transmises en tant que pwzIdentityInfo concernent une identité supprimée et ne sont plus valides.
PEER_E_NOT_AUTHORIZED	L’homologue qui a appelé cette méthode n’est pas un administrateur.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité ou aux clés de groupe d’homologues est refusé. En règle générale, cela est dû à une liste de contrôle d’accès (ACL) incorrecte pour le dossier qui contient les clés d’utilisateur ou d’ordinateur. Cela peut se produire lorsque la liste de contrôle d’accès est réinitialisée manuellement.

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont préfixées par CRYPT_* et définies dans Winerror.h.

Remarques

Les pairs ne peuvent pas créer d’invitations pour les pairs dont le rôle assumé est supérieur à leur propre rôle. Par exemple, un homologue dans un rôle de membre ne peut pas créer d’invitation pour un homologue dans un rôle d’administrateur.

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 de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll

Voir aussi

PEER_CONTACT

PeerGroupParseInvitation

PeerIdentityGetXML

Partager via