Metode IMFHttpDownloadRequest::QueryHeader (mfidl.h)

Artikel
03/15/2023

Dipanggil oleh Microsoft Media Foundation untuk mengambil nilai header HTTP tertentu dari respons ke permintaan HTTP atau HTTPS yang dikirim sebelumnya. Media Foundation memanggil metode ini hanya setelah berhasil memanggil metode EndReceiveResponse .

Sintaks

HRESULT QueryHeader(
  [in]  LPCWSTR szHeaderName,
  [in]  DWORD   dwIndex,
  [out] LPWSTR  *ppszHeaderValue
);

Parameter

[in] szHeaderName

Nama header HTTP yang nilainya sedang dikueri.

[in] dwIndex

Nomor indeks header yang ditentukan, untuk kasus di mana respons berisi beberapa header dengan nama yang sama. Nilai 0 menunjukkan bahwa nilai header pertama dengan nama yang ditentukan diminta, 1 menunjukkan bahwa header kedua diminta, dan sebagainya.

[out] ppszHeaderValue

Atur ke nilai header yang diminta, tidak termasuk karakter pengembalian pengangkutan atau umpan baris. Memori untuk ppszHeaderValue harus dialokasikan dengan CoTaskMemAlloc dan akan dikosongkan oleh Media Foundation dengan CoTaskMemFree.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
S_OK	Berhasil mengembalikan nilai header yang ditentukan dengan indeks yang ditentukan.
E_OUTOFMEMORY	Memori tidak cukup untuk menyelesaikan operasi.
E_POINTER	Parameter ppszHeaderValue adalah penunjuk yang tidak valid.
MF_E_OUT_OF_RANGE	Nilai parameter dwIndex berada di luar rentang.

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

IMFHttpDownloadRequest

Bagikan melalui