Partager via


Fonctions d’API de distribution d’homologues

Le service De distribution d’homologues Microsoft 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 courantes Description
PeerDistStartup Crée une instance PEERDIST_INSTANCE_HANDLE 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 l’état actuel du service de distribution d’homologues.
PeerDistGetStatusEx Retourne l’état et les fonctionnalités actuels du service de distribution d’homologues.
PeerDistGetOverlappedResult Récupère les résultats des opérations asynchrones.
PeerDistRegisterForStatusChangeNotification Demande au service de distribution d’homologues d’avertir l’appelant lorsqu’une modification d’état se produit.
PeerDistRegisterForStatusChangeNotificationEx Demande au service de distribution d’homologues d’avertir l’appelant lorsqu’une modification d’état se produit.
PeerDistUnregisterForStatusChangeNotification Annule l’inscription de la notification de modification d’état 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 du service de distribution homologue 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, cela se produit lorsque les données ne se trouvent pas sur le réseau local, comme indiqué lorsque PeerDistClientBlockRead ou PeerDistClientStreamRead terminée 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 homologue local.
PeerDistClientCancelAsyncOperation Annule l’opération asynchrone associée à une structure de QUI SE CHEVAUCHE ET le 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 de distribution d’homologues.
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 structure SUPERPOSÉE.