Metodo IMFHttpDownloadSession::CreateRequest (mfidl.h)

Richiamato da Microsoft Media Foundation per creare un oggetto che implementa l'interfaccia IMFHttpDownloadRequest, usata per inviare una singola richiesta HTTP o HTTPS. Poiché potrebbero essere necessarie più richieste per scaricare completamente una risorsa, Media Foundation può richiamare CreateRequest più volte nella stessa istanza IMFHttpDownloadSession . Media Foundation userà ogni istanza IMFHttpDownloadRequest 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 di file, di un modulo eseguibile o di un identificatore di ricerca. La risorsa di destinazione inizia sempre con un carattere barra 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, alla richiesta deve essere aggiunta un'intestazione "Pragma: no-cache". Quando si crea una richiesta HTTP/1.1, deve essere aggiunta anche una richiesta "Cache-Control: no-cache".

[in] fSecure

Se impostato su TRUE, fa sì che venga usata la variante sicura del protocollo, se applicabile. Ad esempio, se IMFHttpDownloadSession è per HTTP/HTTPS, l'impostazione di fSecure su TRUE causerà l'uso di HTTPS da parte 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.

[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 viene impostato su un'interfaccia IMFHttpDownloadRequest .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non solo, quelli nella tabella seguente.

Requisiti

Vedere anche

IMFHttpDownloadSession