PeerGroupOpenDirectConnection, fonction (p2p.h)
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 |
---|---|
|
L’un des paramètres n’est pas valide. |
|
Il n’y a pas assez de mémoire disponible pour terminer l’opération. |
|
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. |
|
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 |
Voir aussi
PEER_EVENT_CONNECTION_CHANGE_DATA
PEER_GROUP_EVENT_DIRECT_CONNECTION
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour