PeerDistServerRetrieveContentInformation-Funktion (peerdist.h)

Artikel
03/06/2024

Die PeerDistServerRetrieveContentInformation-Funktion ruft die codierten Inhaltsinformationen ab, die einem von PeerDistServerOpenContentInformation zurückgegebenen Handle zugeordnet sind.

Syntax

DWORD PeerDistServerRetrieveContentInformation(
  [in]      PEERDIST_INSTANCE_HANDLE    hPeerDist,
  [in]      PEERDIST_CONTENTINFO_HANDLE hContentInfo,
            DWORD                       cbMaxNumberOfBytes,
  [in, out] PBYTE                       pBuffer,
  [in]      LPOVERLAPPED                lpOverlapped
);

Parameter

[in] hPeerDist

Eine von PeerDistStartup zurückgegebene PEERDIST_INSTANCE_HANDLE.

[in] hContentInfo

Das von PeerDistServerOpenContentInformation zurückgegebene Handle.

cbMaxNumberOfBytes

Die maximale Anzahl der zu lesenden Bytes.

[in, out] pBuffer

Zeiger auf den Puffer, der die Inhaltsinformationsdaten empfängt.

[in] lpOverlapped

Zeiger auf eine ÜBERLAPPENDE Struktur. Diese Funktion erlaubt es dem Aufrufer nicht, den Startoffset im Inhalt anzugeben. Der Offset wird implizit per hContentInfo beibehalten. Offset und OffsetHigh sind reserviert und müssen null 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 - oder hContentInfo-Handle ist ungültig.
PEERDIST_ERROR_NO_MORE	EOF zu den Inhaltsinformationen wurde erreicht.
ERROR_ACCESS_DISABLED_BY_POLICY	Das Feature wird von Gruppenrichtlinie deaktiviert.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Der Dienst ist nicht verfügbar.

Hinweise

Bei erfolgreicher Ausführung des Vorgangs PeerDistServerRetrieveContentInformation werden die Felder Offset und OffsetHigh der OVERLAPPED-Struktur mit dem ULONGLONGLONG-Offset in den abgerufenen Inhaltsinformationen aufgefüllt. Der OffsetHigh-Member wird auf die höheren 32 Bits des Offsets festgelegt, und der Offset-Member wird auf die unteren 32 Bits des Offsets festgelegt.

GetOverlappedResult füllt lpNumberOfBytesTransferred mit der Anzahl der übertragenen Bytes auf. Wenn der Aufrufer einen Vervollständigungsport verwendet, um Die Vervollständigung der Peerverteilungs-API zu verarbeiten, wird das lpNumberOfBytes-Argument von GetQueuedCompletionStatus mit der Anzahl der übertragenen Bytes aufgefüllt.

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

PeerDistServerOpenContentInformation

PeerDistStartup

Freigeben über