PeerGroupOpenDirectConnection, fonction (p2p.h)

Article
08/25/2023

La fonction PeerGroupOpenDirectConnection établit une connexion directe avec un autre homologue d’un groupe d’homologues.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpenDirectConnection(
  [in]  HGROUP        hGroup,
  [in]  PCWSTR        pwzIdentity,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Paramètres

[in] hGroup

Gérez le groupe d’homologues qui héberge la connexion directe. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pwzIdentity

Pointeur vers une chaîne Unicode qui contient l’identité à laquelle un homologue se connecte. Ce paramètre est obligatoire.

[in] pAddress

Pointeur vers une structure PEER_ADDRESS qui contient l’adresse IPv6 à laquelle l’homologue se connecte. Ce paramètre est obligatoire.

[out] pullConnectionId

Entier 64 bits non signé qui identifie la connexion directe. Cette valeur d’ID ne peut pas être considérée comme valide tant que l’événement PEER_GROUP_EVENT_DIRECT_CONNECTION n’est pas déclenché et indique que la connexion a été acceptée par l’autre homologue. 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_CONNECT_SELF	La connexion a échoué, car il s’agissait d’un bouclage, c’est-à-dire que la connexion se trouve entre un homologue et elle-même.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité d’homologue ou aux clés de groupe d’homologues est refusé. Cela est généralement dû à une liste de contrôle d’accès (ACL) incorrecte pour le dossier qui contient les clés utilisateur ou d’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

Chaque connexion directe ouverte avec cette fonction doit être fermée avec PEER_GROUP_EVENT structure DATA a le membre status de sa structure de composant PEER_EVENT_CONNECTION_CHANGE_DATA défini sur PEER_CONNECTION_FAILED.

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