Fungsi HttpAddRequestHeadersW (wininet.h)
Menambahkan satu atau beberapa header permintaan HTTP ke handel permintaan HTTP.
Sintaks
BOOL HttpAddRequestHeadersW(
[in] HINTERNET hRequest,
[in] LPCWSTR lpszHeaders,
[in] DWORD dwHeadersLength,
[in] DWORD dwModifiers
);
Parameter
[in] hRequest
Handel yang dikembalikan oleh panggilan ke fungsi HttpOpenRequest .
[in] lpszHeaders
Penunjuk ke variabel string yang berisi header untuk ditambahkan ke permintaan. Setiap header harus dihentikan oleh pasangan CR/LF (carriage return/line feed).
[in] dwHeadersLength
Ukuran lpszHeaders, dalam TCHAR. Jika parameter ini adalah -1L, fungsi mengasumsikan bahwa lpszHeaders tidak dihentikan (ASCIIZ), dan panjangnya dihitung.
[in] dwModifiers
Satu set pengubah yang mengontrol semantik fungsi ini. Parameter ini bisa menjadi kombinasi dari nilai berikut.
Nilai kembali
Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
HttpAddRequestHeaders menambahkan header format bebas tambahan ke handel permintaan HTTP dan dimaksudkan untuk digunakan oleh klien canggih yang membutuhkan kontrol terperinci atas permintaan yang tepat yang dikirim ke server HTTP.
Perhatikan bahwa untuk HttpAddRequestHeaders dasar, aplikasi dapat meneruskan beberapa header dalam satu buffer. Jika aplikasi mencoba menghapus atau mengganti header, hanya satu header yang dapat disediakan di lpszHeaders.
Catatan
Header wininet.h mendefinisikan HttpAddRequestHeaders sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | wininet.h |
Pustaka | Wininet.lib |
DLL | Wininet.dll |