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

Возвращает URL-адрес, используемый для отправки запроса.

Синтаксис

HRESULT GetURL(
  [out] LPWSTR *ppszURL
);

Параметры

[out] ppszURL

URL-адрес, используемый для отправки запроса на сервер. Обратите внимание, что этот URL-адрес может отличаться, если сервер выдал http-протокол "redirect". Память для pszURL должна быть выделена с помощью CoTaskMemAlloc и освобождена Media Foundation с CoTaskMemFree.

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

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

Код возврата Описание
S_OK
URL-адрес успешно возвращен.
E_OUTOFMEMORY
Недостаточно памяти для завершения операции.
E_POINTER
Параметр ppszURL является недопустимым указателем.

Комментарии

По умолчанию GetURL возвращает URL-адрес, синтезированный из параметров, предоставляемых Media Foundation в методах IMFHttpDownloadSession::SetServer и IMFHttpDownloadSession::CreateRequest . Однако если HTTP-сервер перенаправил IMFHttpDownloadRequest на другой сервер (т. е. через http-ответ "302 See Other"), метод GetURL возвращает URL-адрес, указанный HTTP-сервером.

Требования

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

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

IMFHttpDownloadRequest