Поделиться через

Метод 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