Метод IMFHttpDownloadRequest::GetTotalLength (mfidl.h)

Вызывается Microsoft Media Foundation для получения общей длины скачиваемого ресурса, если он известен.

Синтаксис

HRESULT GetTotalLength(
  [out] QWORD *pqwTotalLength
);

Параметры

[out] pqwTotalLength

Общая длина скачиваемого ресурса (в байтах), если она известна. Если он неизвестен, задайте значение MAX_ULONG (0xFFFFFFFFFFFFFFFF).

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Операция успешно выполнена.
E_POINTER	Параметр pqwTotalLength является недопустимым указателем.

Комментарии

Microsoft Media Foundation вызывает GetTotalLength только после успешного вызова EndReceiveResponse. Общая длина ресурса может быть больше, чем объем данных, возвращенных сервером в текущем ответе. Например, если запрос включал заголовок "Диапазон" HTTP, данные, возвращаемые в ответе, могут быть меньше общей длины ресурса. Метод GetRangeEndOffset можно использовать для вычисления объема данных, возвращаемого в текущем ответе.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 1703 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	mfidl.h
Библиотека	Mfplat.lib; Mfplat.dll

См. также раздел

IMFHttpDownloadRequest