Peerverteilungs-API-Funktionen

Der Microsoft-Peerverteilungsdienst unterstützt Funktionen sowohl für Szenarien mit Consumerrollen als auch für Herausgeberrollen.

Die folgenden Funktionen sind sowohl in "Client"- als auch "Server"-Szenarien üblich.

Allgemeine Funktionen BESCHREIBUNG
PeerDistStartup Erstellt eine neue PEERDIST_INSTANCE_HANDLE instance, die an alle anderen Peerverteilungs-APIs übergeben werden muss.
PeerDistShutdown Gibt Ressourcen frei, die durch den Aufruf von PeerDistStartup zugeordnet wurden.
PeerDistGetStatus Gibt den aktuellen status des Peerverteilungsdiensts zurück.
PeerDistGetStatusEx Gibt die aktuelle status und Funktionen des Peerverteilungsdiensts zurück.
PeerDistGetOverlappedResult Ruft die Ergebnisse asynchroner Vorgänge ab.
PeerDistRegisterForStatusChangeNotification Fordert an, dass der Peerverteilungsdienst den Aufrufer benachrichtigt, wenn eine status Änderung auftritt.
PeerDistRegisterForStatusChangeNotificationEx Fordert an, dass der Peerverteilungsdienst den Aufrufer benachrichtigt, wenn eine status Änderung auftritt.
PeerDistUnregisterForStatusChangeNotification Hebt die Registrierung der status Änderungsbenachrichtigung für die Sitzung auf, die dem angegebenen Handle zugeordnet ist.

 

Die folgenden Funktionen werden nur in "Client"-Szenarien unterstützt.

Clientfunktionen BESCHREIBUNG
PeerDistClientOpenContent Öffnet und gibt einen PEERDIST_CONTENT_HANDLE zurück, um auf diesen Inhalt zu verweisen.
PeerDistClientCloseContent Schließt die PEERDIST_CONTENT_HANDLE.
PeerDistClientGetInformationByHandle Ruft zusätzliche Informationen vom Peerverteilungsdienst für ein bestimmtes Inhaltshandle ab.
PeerDistClientAddContentInformation Fügt Inhaltsinformationen hinzu, die dann dem PEERDIST_CONTENT_HANDLE zugeordnet sind. Eine PEERDIST_CONTENT_HANDLE kann allen Inhaltsinformationen zugeordnet werden.
PeerDistClientCompleteContentInformation Gibt das Ende der Inhaltsinformationen an.
PeerDistClientAddData Wird zum Bereitstellen von Inhalten für den lokalen Cache verwendet. In der Regel geschieht dies, wenn Daten nicht im lokalen Netzwerk gefunden werden konnten, wie angegeben, wenn PeerDistClientBlockRead oder PeerDistClientStreamRead mit ERROR_TIMEOUT oder PEERDIST_ERROR_MISSING_DATA. abgeschlossen sind.
PeerDistClientBlockRead Ermöglicht zufälligen Zugriff auf den Inhaltsdatenstrom.
PeerDistClientStreamRead Bietet sequenziellen Zugriff auf den Inhaltsdatenstrom.
PeerDistClientFlushContent Entfernt Inhalte, die zuvor dem lokalen Peerverteilungssystem hinzugefügt wurden.
PeerDistClientCancelAsyncOperation Bricht den asynchronen Vorgang ab, der einer OVERLAPPED-Struktur und dem von PeerDistClientOpenContent zurückgegebenen Inhaltshandle zugeordnet ist.

 

Die folgenden Funktionen werden nur in "Server"-Szenarien unterstützt.

Serverfunktionen BESCHREIBUNG
PeerDistServerPublishStream Erstellt die PEERDIST_STREAM_HANDLE , die mit PeerDistServerPublishAddToStream verwendet werden kann, um Inhaltsinformationen für den Inhaltsstream zu erstellen.
PeerDistServerPublishAddToStream Fügt dem Datenstrom, auf den vom PeerDist-Streamhandle verwiesen wird, Daten hinzu.
PeerDistServerPublishCompleteStream Wird aufgerufen, um anzugeben, dass dem Stream alle Daten hinzugefügt wurden.
PeerDistServerCloseStreamHandle Schließt das Datenstromhandle.
PeerDistServerUnpublish Hebt die Veröffentlichung zuvor veröffentlichter Inhalte im Peerverteilungsdienst auf.
PeerDistServerOpenContentInformation Öffnet eine PEERDIST_CONTENTINFO_HANDLE für veröffentlichte Inhalte.
PeerDistServerOpenContentInformationEx Öffnet eine PEERDIST_CONTENTINFO_HANDLE für veröffentlichte Inhalte.
PeerDistServerRetrieveContentInformation Ruft die Inhaltsinformationen ab, die veröffentlichten Inhalten zugeordnet sind.
PeerDistServerCloseContentInformation PEERDIST_CONTENTINFO_HANDLE von PeerDistServerOpenContentInformation geöffnet.
PeerDistServerCancelAsyncOperation Bricht den asynchronen Vorgang ab, der dem Inhaltsbezeichner und der OVERLAPPED-Struktur zugeordnet ist.