Udostępnij przez


Funkcje interfejsu API dystrybucji równorzędnej

Usługa dystrybucji równorzędnej firmy Microsoft obsługuje funkcje zarówno dla scenariuszy roli konsumenta, jak i roli wydawcy.

Następujące funkcje są wspólne w scenariuszach "klient" i "serwer".

Typowe funkcje Opis
PeerDistStartup Tworzy nowe wystąpienie PEERDIST_INSTANCE_HANDLE, które musi zostać przekazane do wszystkich innych interfejsów API dystrybucji równorzędnej.
PeerDistShutdown Zwalnia zasoby przydzielone przez wywołanie metody PeerDistStartup.
PeerDistGetStatus Zwraca bieżący stan usługi dystrybucji równorzędnej.
PeerDistGetStatusEx Zwraca bieżący stan i możliwości usługi dystrybucji równorzędnej.
PeerDistGetOverlappedResult Pobiera wyniki operacji asynchronicznych.
PeerDistRegisterForStatusChangeNotification Żąda, aby usługa dystrybucji równorzędnej powiadamiała obiekt wywołujący o zmianie stanu.
PeerDistRegisterForStatusChangeNotificationEx Żąda, aby usługa dystrybucji równorzędnej powiadamiała obiekt wywołujący o zmianie stanu.
PeerDistUnregisterForStatusChangeNotification Wyrejestrowuje powiadomienie o zmianie stanu dla sesji skojarzonej z podanym dojściem.

 

Następujące funkcje są obsługiwane tylko w scenariuszach "klienta".

Funkcje klienta Opis
PeerDistClientOpenContent Otwiera i zwraca PEERDIST_CONTENT_HANDLE, aby odwoływać się do tej zawartości.
PeerDistClientCloseContent Zamyka PEERDIST_CONTENT_HANDLE.
PeerDistClientInformationByHandle Pobiera dodatkowe informacje z usługi dystrybucji równorzędnej dla określonego dojścia zawartości.
PeerDistClientAddContentInformation Dodaje informacje o zawartości, które są następnie skojarzone z PEERDIST_CONTENT_HANDLE. PEERDIST_CONTENT_HANDLE można skojarzyć z dowolnymi informacjami o zawartości.
PeerDistClientCompleteContentInformation Wskazuje koniec informacji o zawartości.
PeerDistClientAddData Służy do dostarczania zawartości do lokalnej pamięci podręcznej. Zazwyczaj jest to wykonywane, gdy nie można odnaleźć danych w sieci lokalnej, jak wskazano, gdy PeerDistClientBlockRead lub PeerDistClientStreamRead wraz z ERROR_TIMEOUT lub PEERDIST_ERROR_MISSING_DATA..
PeerDistClientBlockRead Zapewnia losowy dostęp do strumienia zawartości.
PeerDistClientStreamRead Zapewnia sekwencyjny dostęp do strumienia zawartości.
PeerDistClientFlushContent Usuwa zawartość, która została wcześniej dodana do lokalnego systemu dystrybucji równorzędnej.
PeerDistClientCancelAsyncOperation Anuluje operację asynchroniczną skojarzoną ze strukturą OVERLAPPED oraz uchwyt zawartości zwrócony przez PeerDistClientOpenContent.

 

Następujące funkcje są obsługiwane tylko w scenariuszach "serwer".

Funkcje serwera Opis
PeerDistServerPublishStream Tworzy PEERDIST_STREAM_HANDLE, które mogą być używane z PeerDistServerPublishAddToStream do tworzenia informacji o zawartości dla strumienia zawartości.
PeerDistServerPublishAddToStream Dodaje dane do strumienia, do których odwołuje się dojście strumienia PeerDist.
PeerDistServerPublishCompleteStream Wywołano polecenie , aby wskazać, że wszystkie dane zostały dodane do strumienia.
PeerDistServerCloseStreamHandle Zamyka uchwyt strumienia.
PeerDistServerUnpublish Nie publikuje wcześniej opublikowanej zawartości w usłudze dystrybucji równorzędnej.
PeerDistServerOpenContentInformation Otwiera PEERDIST_CONTENTINFO_HANDLE dla opublikowanej zawartości.
PeerDistServerOpenContentInformationEx Otwiera PEERDIST_CONTENTINFO_HANDLE dla opublikowanej zawartości.
PeerDistServerRetrieveContentInformation Pobiera informacje o zawartości skojarzone z opublikowaną zawartością.
PeerDistServerCloseContentInformation PEERDIST_CONTENTINFO_HANDLE otwarte przez PeerDistServerOpenContentInformation.
PeerDistServerCancelAsyncOperation Anuluje operację asynchroniczną skojarzona z identyfikatorem zawartości i NAKŁADAJĄCE SIĘ struktury.