PeerGroupCreatePasswordInvitation, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGroupCreatePasswordInvitation retourne une chaîne XML qui peut être utilisée par l’homologue spécifié pour joindre un groupe avec un mot de passe correspondant.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreatePasswordInvitation(
  [in]  HGROUP hGroup,
  [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.

[out] ppwzInvitation

Pointeur vers une chaîne Unicode qui contient l’invitation de l’émetteur. Cette invitation peut être transmise à PeerGroupPasswordJoin par le destinataire pour 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.

Cette fonction nécessite que les champs suivants soient définis sur la structure PEER_GROUP_PROPERTIES passée à PeerGroupCreate.

pwzGroupPassword. Ce champ doit contenir le mot de passe utilisé pour valider les pairs qui rejoignent le groupe d’homologues.
groupPasswordRole. Ce champ doit contenir le GUID du rôle (administrateur ou homologue) pour lequel le mot de passe est requis.
dwAuthenticationSchemes. L’indicateur de PEER_GROUP_PASSWORD_AUTHENTICATION (0x00000001) doit être défini sur ce champ.

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.

Des 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.

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

Partager via