IMFHttpDownloadRequest::GetRangeEndOffset-Methode (mfidl.h)
Wird von Microsoft Media Foundation aufgerufen, um den Offset des letzten Byte in der aktuellen Antwort abzurufen, der vom Anfang der Ressource gezählt wird. Dies ist nützlich, wenn eine Anforderung den HTTP-Header "Range" verwendet, um nur einen Teil einer Ressource herunterzuladen.
Syntax
HRESULT GetRangeEndOffset(
[out] QWORD *pqwRangeEnd
);
Parameter
[out] pqwRangeEnd
Der Offset des letzten Byte in der aktuellen Antwort, der vom Anfang der Ressource gezählt wird, sofern bekannt. Wenn die Anforderung beispielsweise den HTTP-Header "Range: bytes=1000-" angegeben hat und die Größe des Nachrichtentexts in der Antwort 200 Bytes beträgt, wird pwqRangeEnd zu 1199. Wenn der Wert nicht bekannt ist, z. B. weil der Server die Größe seiner Antwort nicht angegeben hat, wird pwqRangeEnd auf MAX_ULONG (0xFFFFFFFFFFFFFFFF) festgelegt.
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 qwpRangeEnd-Parameter ist ein ungültiger Zeiger. |
Hinweise
Microsoft Media Foundation ruft GetRangeEndOffset erst nach dem erfolgreichen Aufruf von EndReceiveResponse auf.
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 |