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

Artigo
08/24/2023

Invocado pelo Microsoft Media Foundation para criar um objeto que implementa a interface IMFHttpDownloadRequest , que é usada para enviar uma única solicitação HTTP ou HTTPS. Como várias solicitações podem ser necessárias para baixar totalmente um recurso, o Media Foundation pode invocar CreateRequest várias vezes na mesma instância IMFHttpDownloadSession . A Media Foundation usará cada instância IMFHttpDownloadRequest para apenas uma única solicitação.

Sintaxe

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

Ponteiro para uma cadeia de caracteres que contém o nome do recurso de destino do verbo HTTP especificado. Geralmente, esse é um nome de arquivo, um módulo executável ou um especificador de pesquisa. O recurso de destino sempre começa com um caractere de barra de avanço e inclui qualquer cadeia de caracteres de consulta incluída na URL.

[in] fBypassProxyCache

Se definido como TRUE, indica que a solicitação deve ser encaminhada para o servidor de origem em vez de enviar uma versão armazenada em cache de um recurso de um servidor proxy. Quando esse sinalizador é definido como TRUE, um cabeçalho "Pragma: no-cache" deve ser adicionado à solicitação. Ao criar uma solicitação HTTP/1.1, um "Cache-Control: no-cache" também deve ser adicionado.

[in] fSecure

Se definido como TRUE, fará com que a variante segura do protocolo seja usada, se aplicável. Por exemplo, se IMFHttpDownloadSession for para HTTP/HTTPS, definir fSecure como TRUE fará com que a solicitação use HTTPS. Caso contrário, a variante não seguro do protocolo (neste exemplo, HTTP) será usada.

[in, optional] szVerb

Ponteiro para uma cadeia de caracteres que contém o verbo HTTP a ser usado na solicitação. Se esse parâmetro for NULL, a função usará GET como o verbo HTTP.

Nota Essa cadeia de caracteres deve estar toda em maiúsculas. Muitos servidores tratam os verbos HTTP como diferenciadores de maiúsculas de minúsculas e as Solicitações de Comentários (RFCs) da Força-Tarefa de Engenharia da Internet (IETF) significam esses verbos usando apenas caracteres maiúsculos.

[in, optional] szReferrer

Ponteiro para uma cadeia de caracteres que especifica a URL do documento do qual a URL na solicitação szObjectName foi obtida. Se esse parâmetro for definido como NULL, nenhum documento de referência será especificado.

ppRequest

Após o retorno bem-sucedido do método, esse parâmetro é definido como uma interface IMFHttpDownloadRequest .

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	Armazenou com êxito as informações fornecidas.
E_OUTOFMEMORY	Não há memória suficiente para concluir a operação.
MF_E_INVALIDREQUEST	O método foi invocado após Fechar ou antes de SetServer ser invocado.

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

IMFHttpDownloadSession

Compartilhar via