IMFHttpDownloadSession::CreateRequest-Methode (mfidl.h)

Artikel
08/24/2023

Wird von Microsoft Media Foundation aufgerufen, um ein Objekt zu erstellen, das die IMFHttpDownloadRequest-Schnittstelle implementiert, die zum Senden einer einzelnen HTTP- oder HTTPS-Anforderung verwendet wird. Da mehrere Anforderungen erforderlich sind, um eine Ressource vollständig herunterzuladen, kann Media Foundation CreateRequest mehrmals auf demselben IMFHttpDownloadSession-instance aufrufen. Media Foundation verwendet jede IMFHttpDownloadRequest-instance nur für eine einzelne Anforderung.

Syntax

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

Parameter

[in] szObjectName

Zeiger auf eine Zeichenfolge, die den Namen der Zielressource des angegebenen HTTP-Verbs enthält. Dies ist in der Regel ein Dateiname, ein ausführbares Modul oder ein Suchbezeichner. Die Zielressource beginnt immer mit einem Schrägstrich und enthält jede Abfragezeichenfolge, die in der URL enthalten war.

[in] fBypassProxyCache

Wenn true festgelegt ist, gibt an, dass die Anforderung an den Ursprungsserver weitergeleitet werden soll, anstatt eine zwischengespeicherte Version einer Ressource von einem Proxyserver zu senden. Wenn dieses Flag auf TRUE festgelegt ist, sollte der Anforderung ein "Pragma: no-cache"-Header hinzugefügt werden. Beim Erstellen einer HTTP/1.1-Anforderung sollte auch ein "Cache-Control: no-cache" hinzugefügt werden.

[in] fSecure

Falls auf TRUE festgelegt, wird ggf. die sichere Variante des Protokolls verwendet. Wenn die IMFHttpDownloadSession beispielsweise für HTTP/HTTPS bestimmt ist, führt das Festlegen von fSecure auf TRUE dazu, dass die Anforderung HTTPS verwendet. Andernfalls wird die unsichere Variante des Protokolls (in diesem Beispiel HTTP) verwendet.

[in, optional] szVerb

Zeiger auf eine Zeichenfolge, die das in der Anforderung zu verwendende HTTP-Verb enthält. Wenn dieser Parameter NULL ist, verwendet die Funktion GET als HTTP-Verb.

Hinweis Diese Zeichenfolge sollte ganz groß geschrieben sein. Viele Server behandeln HTTP-Verben als sensitiv, und die Internet Engineering Task Force (IETF) Requests for Comments (RFCs) schreibt diese Verben nur mit Großbuchstaben.

[in, optional] szReferrer

Zeiger auf eine Zeichenfolge, die die URL des Dokuments angibt, aus dem die URL in der Anforderung szObjectName abgerufen wurde. Wenn dieser Parameter auf NULL festgelegt ist, wird kein verweisendes Dokument angegeben.

ppRequest

Nach erfolgreicher Rückgabe der Methode wird dieser Parameter auf eine IMFHttpDownloadRequest-Schnittstelle festgelegt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die angegebenen Informationen wurden erfolgreich gespeichert.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.
MF_E_INVALIDREQUEST	Die -Methode wurde nach Close oder vor dem Aufruf von SetServer aufgerufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mfplat.lib; Mfplat.dll

Weitere Informationen

IMFHttpDownloadSession

Freigeben über