IMFHttpDownloadRequest::GetRangeEndOffset-Methode (mfidl.h)

  • Artikel

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
S_OK
 Der Vorgang wurde erfolgreich abgeschlossen.
E_POINTER
 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

Weitere Informationen

IMFHttpDownloadRequest