Fonctions de l’API de distribution d’homologues

Le service Microsoft Peer Distribution prend en charge les fonctions pour les scénarios de rôle de consommateur et de rôle d’éditeur.

Les fonctions suivantes sont courantes dans les scénarios « client » et « serveur ».

Fonctions communes	Description
PeerDistStartup	Crée une PEERDIST_INSTANCE_HANDLE instance qui doit être passée à toutes les autres API de distribution d’homologues.
PeerDistShutdown	Libère les ressources allouées par l’appel à PeerDistStartup.
PeerDistGetStatus	Retourne la status actuelle du service de distribution d’homologues.
PeerDistGetStatusEx	Retourne la status et les fonctionnalités actuelles du service de distribution d’homologues.
PeerDistGetOverlappedResult	Récupère les résultats des opérations asynchrones.
PeerDistRegisterForStatusChangeNotification	Demande que le service de distribution d’homologues notifie l’appelant lorsqu’une modification de status se produit.
PeerDistRegisterForStatusChangeNotificationEx	Demande que le service de distribution d’homologues notifie l’appelant lorsqu’une modification de status se produit.
PeerDistUnregisterForStatusChangeNotification	Annule l’inscription de la notification de modification status pour la session associée au handle fourni.

 

Les fonctions suivantes sont uniquement prises en charge dans les scénarios « client ».

Fonctions clientes	Description
PeerDistClientOpenContent	Ouvre et retourne une PEERDIST_CONTENT_HANDLE pour référencer ce contenu.
PeerDistClientCloseContent	Ferme le PEERDIST_CONTENT_HANDLE.
PeerDistClientGetInformationByHandle	Récupère des informations supplémentaires à partir du service peer distribution pour un handle de contenu spécifique.
PeerDistClientAddContentInformation	Ajoute des informations de contenu qui sont ensuite associées au PEERDIST_CONTENT_HANDLE. Une PEERDIST_CONTENT_HANDLE peut être associée à n’importe quelle information de contenu.
PeerDistClientCompleteContentInformation	Indique la fin des informations de contenu.
PeerDistClientAddData	Utilisé pour fournir du contenu au cache local. En règle générale, cette opération est effectuée lorsque les données sont introuvables sur le réseau local, comme indiqué lorsque PeerDistClientBlockRead ou PeerDistClientStreamRead se terminent avec ERROR_TIMEOUT ou PEERDIST_ERROR_MISSING_DATA..
PeerDistClientBlockRead	Fournit un accès aléatoire au flux de contenu.
PeerDistClientStreamRead	Fournit un accès séquentiel au flux de contenu.
PeerDistClientFlushContent	Supprime le contenu qui a été précédemment ajouté au système de distribution d’homologues local.
PeerDistClientCancelAsyncOperation	Annule l’opération asynchrone associée à une structure OVERLAPPED et au handle de contenu retourné par PeerDistClientOpenContent.

 

Les fonctions suivantes sont uniquement prises en charge dans les scénarios « serveur ».

Fonctions serveur	Description
PeerDistServerPublishStream	Crée le PEERDIST_STREAM_HANDLE qui peut être utilisé avec PeerDistServerPublishAddToStream pour créer des informations de contenu pour le flux de contenu.
PeerDistServerPublishAddToStream	Ajoute des données au flux référencé par le handle de flux PeerDist.
PeerDistServerPublishCompleteStream	Appelé pour indiquer que toutes les données ont été ajoutées au flux.
PeerDistServerCloseStreamHandle	Ferme le handle de flux.
PeerDistServerUnpublish	Annule la publication du contenu précédemment publié dans le service peer distribution.
PeerDistServerOpenContentInformation	Ouvre une PEERDIST_CONTENTINFO_HANDLE pour le contenu publié.
PeerDistServerOpenContentInformationEx	Ouvre une PEERDIST_CONTENTINFO_HANDLE pour le contenu publié.
PeerDistServerRetrieveContentInformation	Récupère les informations de contenu associées au contenu publié.
PeerDistServerCloseContentInformation	PEERDIST_CONTENTINFO_HANDLE ouvert par PeerDistServerOpenContentInformation.
PeerDistServerCancelAsyncOperation	Annule l’opération asynchrone associée à l’identificateur de contenu et à la structure CHEVAUCHEMENT.