Freigeben über


IMFHttpDownloadRequest::GetTotalLength-Methode (mfidl.h)

Wird von Microsoft Media Foundation aufgerufen, um die Gesamtlänge der heruntergeladenen Ressource abzurufen, sofern bekannt.

Syntax

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

Parameter

[out] pqwTotalLength

Die Gesamtlänge der heruntergeladenen Ressource in Byte, sofern bekannt. Wenn nicht bekannt, legen Sie den Wert auf MAX_ULONG (0xFFFFFFFFFFFFFFFF) fest.

Zurückgegebener Wert

Die Methode gibt ein HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode Beschreibung
S_OK
Der Vorgang wurde erfolgreich abgeschlossen.
E_POINTER
Der Parameter pqwTotalLength ist ein ungültiger Zeiger.

Bemerkungen

Microsoft Media Foundation ruft GetTotalLength erst nach dem erfolgreichen Aufruf EndReceiveResponse auf. Die Gesamtlänge der Ressource kann größer als die vom Server in der aktuellen Antwort zurückgegebene Datenmenge sein. Wenn die Anforderung beispielsweise den HTTP-Header "Range" enthält, sind die in der Antwort zurückgegebenen Daten möglicherweise kleiner als die Gesamtlänge der Ressource. Die GetRangeEndOffset-Methode kann verwendet werden, um zu berechnen, wie viele Daten in der aktuellen Antwort zurückgegeben werden.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 10, Version 1703 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header mfidl.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Siehe auch

IMFHttpDownloadRequest-