PeerGroupJoin, fonction (p2p.h)

Article
08/25/2023

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
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_INVALID_TIME_PERIOD	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.
PEER_E_INVITATION_NOT_TRUSTED	L’invitation n’est pas approuvée. Cela peut être dû à une modification de l’invitation, à des erreurs ou à l’expiration.
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.

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

Voir aussi

PEER_INVITATION_INFO

PeerGroupConnect

PeerGroupConnectByAddress

PeerGroupCreateInvitation

PeerGroupOpen

PeerGroupParseInvitation