PeerGroupJoin, fonction (p2p.h)
La fonction PeerGroupJoin prépare un homologue avec une invitation à rejoindre un groupe d’homologues existant avant d’appeler PeerGroupConnect ou PeerGroupConnectByAddress.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupJoin(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzInvitation,
[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 est créée lorsque l’homologue invitant appelle PeerGroupCreateInvitation ou PeerGroupIssueCredentials. Vous pouvez obtenir des détails spécifiques concernant cette invitation en tant que structure PEER_INVITATION_INFO en appelant PeerGroupParseInvitation. 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. |
|
La période de validité spécifiée dans l’invitation n’est pas valide. La période spécifiée a expiré ou l’invitation n’est pas encore valide (c’est-à-dire que la date de validitédémarrage spécifiée n’a pas encore été atteinte). L’une des raisons possibles du retour de cette erreur est que l’horloge système est incorrectement définie sur l’ordinateur qui rejoint le groupe ou sur l’ordinateur qui a émis l’invitation. |
|
L’invitation n’est pas approuvée. Cela peut être dû à une modification de l’invitation, à des erreurs ou à l’expiration. |
|
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. |
Les 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.
Spécifications
| 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 |