PeerGroupPasswordJoin, fonction (p2p.h)

Article
08/25/2023

La fonction PeerGroupPasswordJoin prépare un homologue avec une invitation et le mot de passe approprié pour rejoindre un groupe d’homologues protégé par mot de passe avant d’appeler PeerGroupConnect ou PeerGroupConnectByAddress.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupPasswordJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzPassword,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Paramètres

[in] pwzIdentity

Pointeur vers une chaîne Unicode qui contient l’identité ouvrant le groupe d’homologues spécifié. Si ce paramètre a la valeur NULL, l’implémentation utilise l’identité obtenue à partir de PeerIdentityGetDefault.

[in] pwzInvitation

Pointeur vers une chaîne Unicode qui contient l’invitation XML accordée par un autre homologue. Une invitation avec un mot de passe est créée lorsque l’homologue invitant appelle PeerGroupCreatePasswordInvitation. Les détails spécifiques de cette invitation, y compris le mot de passe défini par le créateur du groupe, peuvent être obtenus en tant que structure PEER_INVITATION_INFO en appelant PeerGroupParseInvitation. Ce paramètre est obligatoire.

[in] pwzPassword

Pointeur vers une chaîne Unicode sans fin qui contient le mot de passe requis pour valider et rejoindre le groupe d’homologues. Ce mot de passe doit correspondre au mot de passe spécifié dans l’invitation. Ce paramètre est obligatoire.

[in] pwzCloud

Pointeur vers une chaîne Unicode qui contient le nom du cloud PNRP où se trouve un groupe. La valeur par défaut est NULL, ce qui indique que le cloud spécifié dans l’invitation doit être utilisé.

[out] phGroup

Pointeur vers le handle du groupe d’homologues. Pour démarrer la communication avec un groupe, appelez PeerGroupConnect. Ce paramètre est obligatoire.

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	Il n’y a pas assez de mémoire disponible pour terminer l’opération.
PEER_E_CLOUD_NAME_AMBIGUOUS	Le cloud ne peut pas être découvert de manière unique, par exemple, plusieurs clouds correspondent au nom fourni.
PEER_E_INVALID_PEER_NAME	L’identité d’homologue spécifiée dans pwzIdentity n’est pas valide.
PEER_E_INVITATION_NOT_TRUSTED	L’invitation n’est pas approuvée par l’homologue. Il a été modifié ou contient des erreurs.
PEER_E_NO_CLOUD	Impossible de localiser le cloud.
PEER_E_UNSUPPORTED_VERSION	L’invitation n’est pas prise en charge par la version actuelle de l’infrastructure homologue.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité d’homologue 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 incorrecte pour le dossier qui contient les clés utilisateur ou ordinateur. Cela peut se produire lorsque l’ACL a été réinitialisée manuellement.
PEER_S_ALREADY_A_MEMBER	L’homologue local a tenté de rejoindre un groupe en fonction d’un mot de passe plusieurs fois.

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

Remarques

En cas d’asymétrie d’horloge entre les machines participantes, la fonction PeerGroupPasswordJoin initiale peut toujours réussir, tandis que l’appel suivant de PeerGroupConnect peut entraîner un échec de jointure en fonction de la gravité de l’asymétrie.

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
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll

Voir aussi

PeerGroupConnect

PeerGroupConnectByAddress

Partager via