METODE IMFHttpDownloadSession::CreateRequest (mfidl.h)

Artikel
08/24/2023

Dipanggil oleh Microsoft Media Foundation untuk membuat objek yang mengimplementasikan antarmuka IMFHttpDownloadRequest , yang digunakan untuk mengirim satu permintaan HTTP, atau HTTPS. Karena beberapa permintaan mungkin diperlukan untuk mengunduh sumber daya sepenuhnya, Media Foundation dapat memanggil CreateRequest beberapa kali pada instans IMFHttpDownloadSession yang sama. Media Foundation akan menggunakan setiap instans IMFHttpDownloadRequest hanya untuk satu permintaan.

Sintaks

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

Parameter

[in] szObjectName

Penunjuk ke string yang berisi nama sumber daya target kata kerja HTTP yang ditentukan. Ini umumnya adalah nama file, modul yang dapat dieksekusi, atau penentu pencarian. Sumber daya target selalu dimulai dengan karakter garis miring ke depan dan menyertakan string kueri apa pun yang disertakan pada URL.

[in] fBypassProxyCache

Jika diatur ke TRUE, menunjukkan bahwa permintaan harus diteruskan ke server asal daripada mengirim versi sumber daya yang di-cache dari server proksi. Ketika bendera ini diatur ke TRUE, header "Pragma: no-cache" harus ditambahkan ke permintaan. Saat membuat permintaan HTTP/1.1, "Cache-Control: no-cache" juga harus ditambahkan.

[in] fSecure

Jika diatur ke TRUE, menyebabkan varian protokol aman digunakan, jika berlaku. Misalnya, jika IMFHttpDownloadSession adalah untuk HTTP/HTTPS, mengatur fSecure ke TRUE akan menyebabkan permintaan menggunakan HTTPS. Jika tidak, varian protokol yang tidak aman (dalam contoh ini, HTTP) digunakan.

[in, optional] szVerb

Penunjuk ke string yang berisi kata kerja HTTP untuk digunakan dalam permintaan. Jika parameter ini NULL, fungsi menggunakan GET sebagai kata kerja HTTP.

Catatan String ini harus dalam huruf besar semua. Banyak server memperlakukan kata kerja HTTP sebagai peka huruf besar/kecil, dan Permintaan Internet Engineering Task Force (IETF) untuk Komentar (RFC) mengeja kata kerja ini hanya menggunakan karakter huruf besar.

[in, optional] szReferrer

Penunjuk ke string yang menentukan URL dokumen tempat URL dalam permintaan szObjectName diperoleh. Jika parameter ini diatur ke NULL, tidak ada dokumen rujukan yang ditentukan.

ppRequest

Setelah berhasil mengembalikan metode, parameter ini diatur ke antarmuka IMFHttpDownloadRequest .

Menampilkan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil menyimpan informasi yang disediakan.
E_OUTOFMEMORY	Memori tidak cukup untuk menyelesaikan operasi.
MF_E_INVALIDREQUEST	Metode ini dipanggil setelah Tutup atau sebelum SetServer dipanggil.

Persyaratan


Klien minimum yang didukung	Windows 10, versi 1703 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfplat.lib; Mfplat.dll

Lihat juga

IMFHttpDownloadSession

Bagikan melalui