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

  • Artículo

Llamado por Microsoft Media Foundation para abrir direcciones URL HTTP o HTTPS en lugar de usar la implementación predeterminada.

Sintaxis

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

Parámetros

[in] wszScheme

Nombre del protocolo al que se solicita un IMFHttpDownloadSession . Microsoft Media Foundation especifica el esquema de protocolo de la dirección URL que la aplicación proporcionó a media Foundation Source Resolver. Los valores válidos incluyen "http" para HTTP y "https" para HTTPS. Por lo general, los nombres de esquema de dirección URL no distinguen mayúsculas de minúsculas.

[out] ppDownloadSession

Al ejecutarse correctamente, el parámetro se establece en un puntero a una interfaz IMFHttpDownloadSession . Microsoft Media Foundation usa la interfaz devuelta para abrir una única dirección URL HTTP o HTTPS.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 Se creó correctamente el objeto IMFHttpDownloadSession .
E_INVALIDARG
 El valor especificado para el parámetro wszScheme es incorrecto.
E_POINTER
 El parámetro ppDownloadSession es un puntero no válido.
E_OUTOFMEMORY
 No hay memoria suficiente para completar la operación.

Comentarios

La especificación de "https" como valor de wszScheme no implica que HTTPS se usará para una solicitud determinada, ya que se especifica por solicitud en IMFhttpDownloadSession::CreateRequest.

Requisitos

   
Cliente mínimo compatible Windows 10, versión 1703 [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfplat.lib; Mfplat.dll

Consulte también

IMFHttpDownloadSessionProvider