Partager via

PeerGroupCreatePasswordInvitation, fonction (p2p.h)

  • Article

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