PeerGroupStartup, fonction (p2p.h)
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 |
|---|---|
|
Le service PNRP (Peer Name Resolution Protocol) doit être démarré avant d’appeler PeerGroupStartup. |
|
Il n’y a pas assez de mémoire disponible pour terminer l’opération. |
|
Le service de regroupement n’a pas pu démarrer, car IPv6 n’est pas installé sur l’ordinateur. |
|
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 |