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 |
|---|---|
|
O objeto IMFHttpDownloadSession foi criado com êxito. |
|
O valor especificado para o parâmetro wszScheme está incorreto. |
|
O parâmetro ppDownloadSession é um ponteiro inválido. |
|
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 |