Fonction PeerDistStartup (peerdist.h)
La fonction PeerDistStartup crée un nouveau handle de distribution d’homologues instance qui doit être passé à toutes les autres API de distribution d’homologues.
Syntaxe
DWORD PeerDistStartup(
[in] DWORD dwVersionRequested,
[out] PPEERDIST_INSTANCE_HANDLE phPeerDist,
[out, optional] PDWORD pdwSupportedVersion
);
Paramètres
[in] dwVersionRequested
Contient la version minimale de la distribution d’homologue demandée par l’application. L’octet d’ordre élevé spécifie le numéro de version mineure ; l’octet d’ordre inférieur spécifie le numéro de version principale.
[out] phPeerDist
Pointeur vers une variable PEERDIST_INSTANCE_HANDLE qui, en cas de réussite, reçoit un handle nouvellement créé.
[out, optional] pdwSupportedVersion
Pointeur vers une variable qui, si elle n’est pas NULL, contient le numéro de version maximal pris en charge par le système de distribution d’homologues. L’octet d’ordre élevé spécifie le numéro de version mineure ; l’octet d’ordre inférieur spécifie le numéro de version principale.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Sinon, la fonction peut retourner l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
|
Un ou plusieurs paramètres ne sont pas valides. |
|
La version demandée n’est pas prise en charge par la DLL côté client. |
Remarques
PeerDistStartup doit être appelé avant toutes les autres fonctions de distribution d’homologues. Lorsqu’il n’est plus nécessaire, le handle retourné par PeerDistStartup doit être fermé via un appel à PeerDistShutdown.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | peerdist.h |
| Bibliothèque | PeerDist.lib |
| DLL | PeerDist.dll |