Compartilhar via

Método IMFHttpDownloadRequest::GetURL (mfidl.h)

  • Artigo

Retorna a URL usada para enviar a solicitação.

Sintaxe

HRESULT GetURL(
  [out] LPWSTR *ppszURL
);

Parâmetros

[out] ppszURL

A URL usada para enviar a solicitação para o servidor. Observe que essa URL poderá ser diferente se o servidor tiver emitido um protocolo HTTP "redirecionamento". A memória para pszURL deve ser alocada com CoTaskMemAlloc e será liberada pela Media Foundation com CoTaskMemFree.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 Retornou com êxito a URL.
E_OUTOFMEMORY
 Não há memória suficiente para concluir a operação.
E_POINTER
 O parâmetro ppszURL é um ponteiro inválido.

Comentários

Por padrão, GetURL retorna uma URL sintetizada dos parâmetros fornecidos pelo Media Foundation nos métodos IMFHttpDownloadSession::SetServer e IMFHttpDownloadSession::CreateRequest . No entanto, se o servidor HTTP tiver redirecionado o IMFHttpDownloadRequest para um servidor diferente (ou seja, por meio de uma resposta HTTP "302 See Other"), o método GetURL retornará a URL especificada pelo servidor HTTP.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfplat.lib; Mfplat.dll

Confira também

IMFHttpDownloadRequest