PeerGroupOpen, fonction (p2p.h)

Article
08/25/2023

La fonction PeerGroupOpen ouvre un groupe d’homologues qu’un homologue a créé ou joint. Une fois qu’un groupe d’homologues est ouvert, l’homologue peut s’inscrire aux notifications d’événements.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpen(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzGroupPeerName,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Paramètres

[in] pwzIdentity

Pointeur vers une chaîne Unicode qui contient l’identité qu’un homologue utilise pour ouvrir un groupe. Ce paramètre est obligatoire.

[in] pwzGroupPeerName

Pointeur vers une chaîne Unicode qui contient le nom d’homologue du groupe d’homologues. Ce paramètre est obligatoire.

[in] pwzCloud

Pointeur vers une chaîne Unicode qui contient le nom du cloud PNRP dans lequel se trouve le groupe d’homologues. Si la valeur est NULL, le cloud spécifié dans les propriétés du groupe d’homologues est utilisé.

[out] phGroup

Pointeur vers un handle pour un groupe d’homologues. Si cette valeur est NULL, l’opération d’ouverture échoue. 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 spécifié dans pwzCloud ne peut pas être découvert de manière unique, par exemple, plusieurs clouds correspondent au nom fourni.
PEER_E_NO_CLOUD	Impossible de localiser le cloud spécifié dans pwzCloud .
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.

Notes

Plusieurs applications peuvent ouvrir le même groupe simultanément. N’importe quelle application peut choisir d’ouvrir un groupe sans appeler par la suite PeerGroupConnect. Ces applications sont considérées comme hors connexion. Toutefois, une deuxième application peut ouvrir et connecter l’homologue au groupe, ce qui signifie qu’une application doit être prête à se connecter à tout moment.

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

Partager via