PeerGroupPasswordJoin, fonction (p2p.h)
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 |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
Il n’y a pas assez de mémoire disponible pour terminer l’opération. |
|
Le cloud ne peut pas être découvert de manière unique, par exemple, plusieurs clouds correspondent au nom fourni. |
|
L’identité d’homologue spécifiée dans pwzIdentity n’est pas valide. |
|
L’invitation n’est pas approuvée par l’homologue. Il a été modifié ou contient des erreurs. |
|
Impossible de localiser le cloud. |
|
L’invitation n’est pas prise en charge par la version actuelle de l’infrastructure homologue. |
|
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. |
|
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 |