PeerDistClientAddData-Funktion (peerdist.h)

Artikel
08/25/2023

Die Funktion 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 entweder PeerDistClientBlockRead oder PeerDistClientStreamRead mit ERROR_TIMEOUT oder PEERDIST_ERROR_MISSING_DATA.

Syntax

DWORD PeerDistClientAddData(
  [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 vonPeerDistClientOpenContent zurückgegebene PEERDIST_CONTENT_HANDLE.

cbNumberOfBytes

Die Anzahl der Bytes, die dem lokalen Cache hinzugefügt werden sollen.

[in] pBuffer

Zeiger auf den Puffer, der die Daten enthält, die dem lokalen Cache hinzugefügt werden sollen. 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. Der Byteoffset vom Anfang des Inhalts, an dem diese Daten hinzugefügt werden, wird durch Festlegen der Offset - und OffsetHigh-Elemente der OVERLAPPED-Struktur angegeben. Der OffsetHigh-Member MUSS auf die höheren 32 Bits des Byteoffsets festgelegt werden, und der Offset-Member MUSS auf die unteren 32 Bits des Byteoffsets festgelegt werden.

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 - oder hContent-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

Die Daten, die mit dieser Funktion hinzugefügt wurden und die Überprüfung bestanden wurde, stehen anderen Peers oder gehosteten Cache zum Download zur Verfügung. Der Peerverteilungsdienst speichert diese Daten im lokalen Cache.

Wenn die API mit PEERDIST_ERROR_OUT_OF_BOUNDS abgeschlossen wird, gibt dies an, dass der in der überlappenden Struktur angegebene Offset über das Ende des Inhalts hinaus liegt.

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

PeerDistClientBlockRead

PeerDistClientStreamRead

PeerDistStartup

Freigeben über