Método IMFHttpDownloadSession::CreateRequest (mfidl.h)

  • Artículo

Invocado por Microsoft Media Foundation para crear un objeto que implemente la interfaz IMFHttpDownloadRequest , que se usa para enviar una única solicitud HTTP o HTTPS. Dado que es posible que se necesiten varias solicitudes para descargar completamente un recurso, Media Foundation puede invocar CreateRequest varias veces en la misma instancia imfHttpDownloadSession . Media Foundation usará cada instancia imfHttpDownloadRequest solo para una sola solicitud.

Sintaxis

HRESULT CreateRequest(
  [in]           LPCWSTR                szObjectName,
  [in]           BOOL                   fBypassProxyCache,
  [in]           BOOL                   fSecure,
  [in, optional] LPCWSTR                szVerb,
  [in, optional] LPCWSTR                szReferrer,
                 IMFHttpDownloadRequest **ppRequest
);

Parámetros

[in] szObjectName

Puntero a una cadena que contiene el nombre del recurso de destino del verbo HTTP especificado. Por lo general, se trata de un nombre de archivo, un módulo ejecutable o un especificador de búsqueda. El recurso de destino siempre comienza con un carácter de barra diagonal e incluye cualquier cadena de consulta incluida en la dirección URL.

[in] fBypassProxyCache

Si se establece en TRUE, indica que la solicitud se debe reenviar al servidor de origen en lugar de enviar una versión almacenada en caché de un recurso desde un servidor proxy. Cuando esta marca se establece en TRUE, se debe agregar un encabezado "Pragma: no-cache" a la solicitud. Al crear una solicitud HTTP/1.1, también se debe agregar un "Cache-Control: no-cache".

[in] fSecure

Si se establece en TRUE, hace que se use la variante segura del protocolo, si procede. Por ejemplo, si IMFHttpDownloadSession es para HTTP/HTTPS, establecer fSecure en TRUE hará que la solicitud use HTTPS. De lo contrario, se usa la variante no segura del protocolo (en este ejemplo, HTTP).

[in, optional] szVerb

Puntero a una cadena que contiene el verbo HTTP que se va a usar en la solicitud. Si este parámetro es NULL, la función usa GET como verbo HTTP.

Nota Esta cadena debe estar en mayúsculas. Muchos servidores tratan verbos HTTP con distinción entre mayúsculas y minúsculas, y las solicitudes del Grupo de tareas de ingeniería de Internet (IETF) escriben estos verbos solo con caracteres en mayúsculas.
 

[in, optional] szReferrer

Puntero a una cadena que especifica la dirección URL del documento desde la que se obtuvo la dirección URL de la solicitud szObjectName . Si este parámetro se establece en NULL, no se especifica ningún documento de referencia.

ppRequest

Tras la devolución correcta del método, este parámetro se establece en una interfaz IMFHttpDownloadRequest .

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
 Almacenó correctamente la información proporcionada.
E_OUTOFMEMORY
 No hay memoria suficiente para completar la operación.
MF_E_INVALIDREQUEST
 El método se invocó después de que se invoque Close o antes de que se invoque SetServer .

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

IMFHttpDownloadSession