PeerDistClientAddContentInformation-Funktion (peerdist.h)

Artikel
08/25/2023

Die Funktion PeerDistClientAddContentInformation fügt die Inhaltsinformationen hinzu, die einem von PeerDistClientOpenContent geöffneten Inhaltshandle zugeordnet sind.

Syntax

DWORD PeerDistClientAddContentInformation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in] PEERDIST_CONTENT_HANDLE  hContentHandle,
       DWORD                    cbNumberOfBytes,
  [in] PBYTE                    pBuffer,
  [in] LPOVERLAPPED             lpOverlapped
);

Parameter

[in] hPeerDist

Eine vonPeerDistStartup zurückgegebene PEERDIST_INSTANCE_HANDLE.

[in] hContentHandle

Eine PEERDIST_CONTENT_HANDLE von PeerDistClientOpenContent geöffnet.

cbNumberOfBytes

Anzahl der Bytes im pBuffer-Array .

[in] pBuffer

Zeiger auf den Puffer, der die Inhaltsinformationen enthält. Dieser Puffer muss für die Dauer des Add-Vorgangs gültig bleiben. Der Aufrufer darf diesen Puffer erst verwenden, wenn der Add-Vorgang abgeschlossen ist.

[in] lpOverlapped

Zeiger auf eine ÜBERLAPPENDE Struktur. Das interne Element der OVERLAPPED-Struktur enthält die Vervollständigung status des asynchronen Vorgangs. Offset und OffsetHigh sind reserviert und müssen 0 sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_IO_PENDING. Andernfalls gibt die Funktion möglicherweise einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig.
ERROR_INVALID_HANDLE	Das hPeerDist-Handle ist ungültig.
ERROR_ACCESS_DISABLED_BY_POLICY	Das Feature wird von Gruppenrichtlinie deaktiviert.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Der Dienst ist nicht verfügbar.

Hinweise

Um Inhaltsdaten aus dem Peerverteilungsdienst abzurufen, muss der Client Inhaltsinformationen hinzufügen, die er vom Inhaltsserver empfangen hat, indem er die Funktion PeerDistClientAddContentInformation aufruft . Wenn alle Inhaltsinformationsdaten hinzugefügt wurden, muss die Funktion PeerDistClientCompleteContentInformation aufgerufen werden. Sobald PeerDistClientCompleteContentInformation abgeschlossen ist, kann der Client PeerDistClientStreamRead oder PeerDistClientBlockRead aufrufen, um die Daten aus dem Peerverteilungssystem abzurufen.

Wenn diese Funktion mehrmals für ein einzelnes Inhaltshandle aufgerufen wird, muss der Aufrufer warten, bis jeder Vorgang abgeschlossen ist, bevor der nächste Aufruf erfolgt.

Eine Anwendung ist nicht auf das Hinzufügen von Inhaltsinformationen mit einem einzelnen PeerDistClientAddContentInformation-API-Aufruf beschränkt, da es möglich ist, Teile dieser Inhaltsinformationen hinzuzufügen, während sie verfügbar gemacht werden. Wenn weitere Inhaltsinformationen verfügbar sind, kann die Anwendung peerDistClientAddContentInformation erneut aufrufen. Wenn die Anwendung mit dem Hinzufügen der gesamten Inhaltsinformationen fertig ist, muss sie PeerDistClientCompleteContentInformation aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	peerdist.h
Bibliothek	PeerDist.lib
DLL	PeerDist.dll

Weitere Informationen

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup

Freigeben über