Método IMFHttpDownloadSessionProvider::CreateHttpDownloadSession (mfidl.h)

Chamado pelo Microsoft Media Foundation para abrir URLs HTTP ou HTTPS em vez de usar a implementação padrão.

Sintaxe

HRESULT CreateHttpDownloadSession(
  [in]  LPCWSTR                wszScheme,
  [out] IMFHttpDownloadSession **ppDownloadSession
);

Parâmetros

[in] wszScheme

O nome do protocolo para o qual um IMFHttpDownloadSession está sendo solicitado. O Microsoft Media Foundation especifica o esquema de protocolo da URL que o aplicativo forneceu ao Resolvedor de Origem do Media Foundation. Os valores válidos incluem "http" para HTTP e "https" para HTTPS. Os nomes de esquema de URL geralmente não diferenciam maiúsculas de minúsculas.

[out] ppDownloadSession

Na execução bem-sucedida, o parâmetro é definido como um ponteiro para uma interface IMFHttpDownloadSession . A interface retornada é usada pelo Microsoft Media Foundation para abrir uma única URL HTTP ou HTTPS.

Valor retornado

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	O objeto IMFHttpDownloadSession foi criado com êxito.
E_INVALIDARG	O valor especificado para o parâmetro wszScheme está incorreto.
E_POINTER	O parâmetro ppDownloadSession é um ponteiro inválido.
E_OUTOFMEMORY	Não há memória suficiente para concluir a operação.

Comentários

Especificar "https" como o valor de wszScheme não implica que HTTPS será usado para uma solicitação específica, pois isso é especificado por solicitação em IMFhttpDownloadSession::CreateRequest.

Requisitos

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

IMFHttpDownloadSessionProvider