PeerGroupStartup, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGroupStartup lance un groupe d’homologues à l’aide d’une version demandée de l’infrastructure Peer.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupStartup(
  [in]  WORD               wVersionRequested,
  [out] PPEER_VERSION_DATA pVersionData
);

Paramètres

[in] wVersionRequested

Spécifie la version la plus élevée de l’infrastructure d’homologue qu’un appelant peut prendre en charge. L’octet d’ordre élevé spécifie le numéro de version mineure (révision). L’octet d’ordre inférieur spécifie le numéro de version principale Ce paramètre est obligatoire.

[out] pVersionData

Pointeur vers une structure de PEER_VERSION_DATA qui contient le niveau de prise en charge spécifique fourni par l’infrastructure homologue. Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si la fonction réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour	Description
ERROR_SERVICE_DEPENDENCY_FAIL	Le service PNRP (Peer Name Resolution Protocol) doit être démarré avant d’appeler PeerGroupStartup.
E_OUTOFMEMORY	Il n’y a pas assez de mémoire disponible pour terminer l’opération.
PEER_E_IPV6_NOT_INSTALLED	Le service de regroupement n’a pas pu démarrer, car IPv6 n’est pas installé sur l’ordinateur.
PEER_E_UNSUPPORTED_VERSION	La version demandée n’est pas prise en charge par le sous-système Homologue installé.

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.

Remarques

Le service PNRP (Peer Name Resolution Protocol) doit être démarré avant d’appeler cette fonction.

Cette fonction est appelée par l’application avant d’appeler toute autre fonction de regroupement d’homologues.

Pour cette version, les applications doivent utiliser PEER_GROUP_VERSION comme version demandée.

Un groupe d’homologues démarré avec cette fonction est fermé en appelant PeerGroupShutdown lorsque l’application se termine.

Configuration requise

Condition requise	Valeur
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

Regroupement des fonctions d’API

PEER_VERSION_DATA

PeerGroupShutdown

Partager via