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 Bytes), sofern bekannt. Wenn nicht bekannt, legen Sie auf MAX_ULONG (0xFFFFFFFFFFFFFFFF) fest.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der pqwTotalLength-Parameter ist ein ungültiger Zeiger. |
Hinweise
Microsoft Media Foundation ruft GetTotalLength erst nach dem erfolgreichen Aufruf von EndReceiveResponse auf. Die Gesamtlänge der Ressource kann größer sein als die Vom Server in der aktuellen Antwort zurückgegebene Datenmenge. Wenn die Anforderung beispielsweise den HTTP-Header "Range" enthält, können die in der Antwort zurückgegebenen Daten kleiner als die Gesamtlänge der Ressource sein. Die GetRangeEndOffset-Methode kann verwendet werden, um zu berechnen, wie viele Daten in der aktuellen Antwort zurückgegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1703 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mfidl.h |
| Bibliothek | Mfplat.lib; Mfplat.dll |