Metodo IMFHttpDownloadSession::CreateRequest (mfidl.h)

Articolo
08/24/2023

Richiamato da Microsoft Media Foundation per creare un oggetto che implementa l'interfaccia IMFHttpDownloadRequest , utilizzata per inviare una singola richiesta HTTP o HTTPS. Poiché più richieste possono essere necessarie per scaricare completamente una risorsa, Media Foundation può richiamare CreateRequest più volte nella stessa istanza di FMHttpDownloadSession . Media Foundation userà ogni istanza di FMHttpDownloadRequest solo per una singola richiesta.

Sintassi

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

Parametri

[in] szObjectName

Puntatore a una stringa contenente il nome della risorsa di destinazione del verbo HTTP specificato. Si tratta in genere di un nome file, di un modulo eseguibile o di un identificatore di ricerca. La risorsa di destinazione inizia sempre con un carattere barra in avanti e include qualsiasi stringa di query inclusa nell'URL.

[in] fBypassProxyCache

Se impostato su TRUE, indica che la richiesta deve essere inoltrata al server di origine anziché inviare una versione memorizzata nella cache di una risorsa da un server proxy. Quando questo flag è impostato su TRUE, deve essere aggiunta un'intestazione "Pragma: no-cache" alla richiesta. Quando si crea una richiesta HTTP/1.1, è necessario aggiungere anche "Cache-Control: no-cache".

[in] fSecure

Se impostato su TRUE, la variante sicura del protocollo deve essere usata, se applicabile. Ad esempio, se fmiHttpDownloadSession è per HTTP/HTTPS, l'impostazione di fSecure su TRUE causerà l'uso di HTTPS della richiesta. In caso contrario, viene usata la variante non protetta del protocollo (in questo esempio HTTP).

[in, optional] szVerb

Puntatore a una stringa contenente il verbo HTTP da usare nella richiesta. Se questo parametro è NULL, la funzione usa GET come verbo HTTP.

Nota Questa stringa deve essere tutta maiuscola. Molti server considerano i verbi HTTP come distinzione tra maiuscole e minuscole e le richieste di Internet Engineering Task Force (IETF) per i commenti (RFC) includono questi verbi usando solo caratteri maiuscoli.

[in, optional] szReferrer

Puntatore a una stringa che specifica l'URL del documento da cui è stato ottenuto l'URL nella richiesta szObjectName . Se questo parametro è impostato su NULL, non viene specificato alcun documento di riferimento.

ppRequest

Al termine della restituzione del metodo, questo parametro è impostato su un'interfaccia IMFHttpDownloadRequest .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Sono state archiviate correttamente le informazioni fornite.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
MF_E_INVALIDREQUEST	Il metodo è stato richiamato dopo Close o prima che SetServer sia stato richiamato.

Requisiti


Client minimo supportato	Windows 10 versione 1703 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mfplat.lib; Mfplat.dll

Vedi anche

FMHttpDownloadSession

Condividi tramite