Bagikan melalui


Bendera Info Kueri (Winhttp.h)

Atribut dan pengubah ini digunakan oleh WinHttpQueryHeaders.

Bendera atribut digunakan oleh WinHttpQueryHeaders untuk menunjukkan informasi apa yang akan diambil. Sebagian besar bendera atribut memetakan langsung ke header HTTP tertentu. Ada juga beberapa bendera khusus, seperti WINHTTP_QUERY_RAW_HEADERS, yang tidak terkait dengan header tertentu.

WINHTTP_QUERY_ACCEPT

Mengambil jenis media yang dapat diterima untuk respons.

WINHTTP_QUERY_ACCEPT_CHARSET

Mengambil set karakter yang dapat diterima untuk respons.

WINHTTP_QUERY_ACCEPT_ENCODING

Mengambil nilai pengkodian konten yang dapat diterima untuk respons.

WINHTTP_QUERY_ACCEPT_LANGUAGE

Mengambil bahasa alami yang dapat diterima untuk respons.

WINHTTP_QUERY_ACCEPT_RANGES

Mengambil jenis permintaan rentang yang diterima untuk sumber daya.

WINHTTP_QUERY_AGE

Mengambil bidang header respons Usia, yang berisi perkiraan pengirim tentang jumlah waktu sejak respons dihasilkan di server asal.

WINHTTP_QUERY_ALLOW

Menerima kata kerja HTTP yang didukung oleh server.

WINHTTP_QUERY_AUTHENTICATION_INFO

Mengambil header Authentication-Info.

WINHTTP_QUERY_AUTHORIZATION

Mengambil kredensial otorisasi yang digunakan untuk permintaan.

WINHTTP_QUERY_CACHE_CONTROL

Mengambil arahan kontrol cache.

WINHTTP_QUERY_CONNECTION

Mengambil opsi apa pun yang ditentukan untuk koneksi tertentu dan tidak boleh dikomunikasikan oleh proksi melalui koneksi lebih lanjut.

WINHTTP_QUERY_CONTENT_BASE

Mengambil Pengidentifikasi Sumber Daya Seragam (URI) dasar untuk menyelesaikan URL relatif dalam entitas.

WINHTTP_QUERY_CONTENT_DESCRIPTION

Kedaluwarsa. Dipertahankan untuk kompatibilitas aplikasi warisan.

WINHTTP_QUERY_CONTENT_DISPOSITION

Kedaluwarsa. Dipertahankan untuk kompatibilitas aplikasi warisan.

WINHTTP_QUERY_CONTENT_ENCODING

Mengambil pengkodian konten tambahan yang telah diterapkan ke seluruh sumber daya.

WINHTTP_QUERY_CONTENT_ID

Mengambil identifikasi konten.

WINHTTP_QUERY_CONTENT_LANGUAGE

Mengambil bahasa tempat konten ditulis.

WINHTTP_QUERY_CONTENT_LENGTH

Mengambil ukuran sumber daya, dalam byte.

WINHTTP_QUERY_CONTENT_LOCATION

Mengambil lokasi sumber daya untuk entitas yang diapit dalam pesan.

WINHTTP_QUERY_CONTENT_MD5

Mengambil hash MD5 dari isi entitas untuk tujuan memberikan pemeriksaan integritas pesan end-to-end untuk badan entitas. Untuk informasi selengkapnya, lihat RFC 1864.

WINHTTP_QUERY_CONTENT_RANGE

Mengambil lokasi di badan entitas lengkap tempat badan entitas parsial harus dimasukkan dan ukuran total badan entitas penuh.

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

Mengambil transformasi pengodean yang berlaku untuk badan entitas. Ini mungkin sudah diterapkan, mungkin perlu diterapkan, atau mungkin berlaku secara opsional.

WINHTTP_QUERY_CONTENT_TYPE

Menerima tipe konten sumber daya, seperti teks atau html.

WINHTTP_QUERY_COOKIE

Mengambil cookie apa pun yang terkait dengan permintaan.

WINHTTP_QUERY_COST

Tidak didukung.

WINHTTP_QUERY_CUSTOM

Menyebabkan WinHttpQueryHeaders mencari nama header yang ditentukan dalam parameter pwszName dan menyimpan informasi header di lpBuffer. Aplikasi dapat menggunakan WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT untuk membatasi waktu maksimum kueri ini menunggu semua header diterima.

WINHTTP_QUERY_DATE

Menerima tanggal dan waktu asal pesan.

WINHTTP_QUERY_DERIVED_FROM

Tidak didukung.

WINHTTP_QUERY_ETAG

Mengambil tag entitas untuk entitas terkait.

WINHTTP_QUERY_EXPECT

Mengambil header Expect, yang menunjukkan apakah aplikasi klien harus mengharapkan respons seri 100.

WINHTTP_QUERY_EXPIRES

Menerima tanggal dan waktu setelah itu sumber daya harus dianggap kedaluarsa.

WINHTTP_QUERY_FORWARDED

Kedaluwarsa. Dipertahankan untuk kompatibilitas aplikasi warisan.

WINHTTP_QUERY_FROM

Mengambil alamat email untuk pengguna yang mengontrol agen pengguna yang meminta jika header Dari diberikan.

WINHTTP_QUERY_HOST

Mengambil host Internet dan nomor port sumber daya yang diminta.

WINHTTP_QUERY_IF_MATCH

Mengambil konten bidang If-Match request-header.

WINHTTP_QUERY_IF_MODIFIED_SINCE

Mengambil konten header If-Modified-Since.

WINHTTP_QUERY_IF_NONE_MATCH

Mengambil konten bidang request-header If-None-Match.

WINHTTP_QUERY_IF_RANGE

Mengambil konten bidang If-Range request-header. Header ini memungkinkan aplikasi klien untuk memeriksa apakah entitas yang terkait dengan salinan parsial entitas dalam cache aplikasi klien belum diperbarui. Jika entitas belum diperbarui, kirim bagian yang hilang dari aplikasi klien. Jika entitas telah diperbarui, kirim seluruh entitas yang diperbarui.

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

Mengambil konten bidang request-header If-Unmodified-Since.

WINHTTP_QUERY_LINK

Kedaluwarsa. Dipertahankan untuk kompatibilitas aplikasi warisan.

WINHTTP_QUERY_LAST_MODIFIED

Menerima tanggal dan waktu di mana sumber daya terakhir diubah. Tanggal dan waktu ditentukan oleh server.

WINHTTP_QUERY_LOCATION

Mengambil URI absolut yang digunakan dalam header respons Lokasi.

WINHTTP_QUERY_MAX

Menunjukkan nilai maksimum nilai WINHTTP_QUERY_*. Bukan bendera kueri.

WINHTTP_QUERY_MAX_FORWARDS

Mengambil jumlah proksi atau gateway yang dapat meneruskan permintaan ke server masuk berikutnya.

WINHTTP_QUERY_MESSAGE_ID

Tidak didukung.

WINHTTP_QUERY_MIME_VERSION

Menerima versi protokol Ekstensi Surat Internet Multiguna (MIME) yang digunakan untuk membuat pesan.

WINHTTP_QUERY_ORIG_URI

Kedaluwarsa. Dipertahankan untuk kompatibilitas aplikasi warisan.

WINHTTP_QUERY_PRAGMA

Menerima arahan khusus implementasi yang mungkin berlaku untuk penerima mana pun di sepanjang rantai permintaan/respons.

WINHTTP_QUERY_PROXY_AUTHENTICATE

Mengambil skema autentikasi dan realm yang dikembalikan oleh proksi.

WINHTTP_QUERY_PROXY_AUTHORIZATION

Mengambil header yang digunakan untuk mengidentifikasi pengguna ke proksi yang memerlukan autentikasi. Header ini hanya dapat diambil sebelum permintaan dikirim ke server.

WINHTTP_QUERY_PROXY_CONNECTION

Mengambil header Proxy-Connection.

WINHTTP_QUERY_PROXY_SUPPORT

Mengambil header Proxy-Support.

WINHTTP_QUERY_PUBLIC

Menerima kata kerja HTTP yang tersedia di server ini.

WINHTTP_QUERY_RANGE

Mengambil rentang byte entitas.

WINHTTP_QUERY_RAW_HEADERS

Menerima semua header yang dikembalikan oleh server. Setiap header dihentikan oleh "\0". "\0" tambahan mengakhiri daftar header.

WINHTTP_QUERY_RAW_HEADERS_CRLF

Menerima semua header yang dikembalikan oleh server. Setiap header dipisahkan oleh urutan kembali/umpan baris (CR/LF) pengangkutan.

WINHTTP_QUERY_REFERER

Menerima URI sumber daya tempat URI yang diminta diperoleh.

WINHTTP_QUERY_REFRESH

Kedaluwarsa. Dipertahankan untuk kompatibilitas aplikasi warisan.

WINHTTP_QUERY_REQUEST_METHOD

Menerima kata kerja HTTP yang sedang digunakan dalam permintaan, biasanya GET atau POST.

WINHTTP_QUERY_RETRY_AFTER

Mengambil jumlah waktu layanan diperkirakan tidak tersedia.

WINHTTP_QUERY_SERVER

Mengambil informasi tentang perangkat lunak yang digunakan oleh server asal untuk menangani permintaan.

WINHTTP_QUERY_SET_COOKIE

Menerima nilai cookie yang ditetapkan untuk permintaan tersebut.

WINHTTP_QUERY_STATUS_CODE

Menerima kode status yang dikembalikan oleh server. Untuk daftar nilai yang mungkin, lihat Kode Status HTTP.

WINHTTP_QUERY_STATUS_TEXT

Menerima teks tambahan yang dikembalikan oleh server pada baris respons.

WINHTTP_QUERY_TITLE

Kedaluwarsa. Dipertahankan untuk kompatibilitas aplikasi warisan.

WINHTTP_QUERY_TRANSFER_ENCODING

Mengambil jenis transformasi yang telah diterapkan ke isi pesan sehingga dapat ditransfer dengan aman antara pengirim dan penerima.

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

Mengambil header Kecuali-Diubah-Sejak.

WINHTTP_QUERY_UPGRADE

Mengambil protokol komunikasi tambahan yang didukung oleh server.

WINHTTP_QUERY_URI

Menerima beberapa atau semua URI tempat sumber daya Request-URI dapat diidentifikasi.

WINHTTP_QUERY_USER_AGENT

Mengambil informasi tentang agen pengguna yang membuat permintaan.

WINHTTP_QUERY_VARY

Mengambil header yang menunjukkan bahwa entitas dipilih dari sejumlah representasi respons yang tersedia menggunakan negosiasi berbasis server.

WINHTTP_QUERY_VERSION

Mengambil versi HTTP yang ada di baris status.

WINHTTP_QUERY_VIA

Mengambil protokol perantara dan penerima antara agen pengguna dan server berdasarkan permintaan, dan antara server asal dan klien pada respons.

WINHTTP_QUERY_WARNING

Mengambil informasi tambahan tentang status respons yang mungkin tidak tercermin oleh kode status respons.

WINHTTP_QUERY_WWW_AUTHENTICATE

Mengambil skema autentikasi dan realm yang dikembalikan oleh server.

Bendera pengubah digunakan bersama dengan bendera atribut untuk mengubah permintaan. Bendera pengubah mengubah format data yang dikembalikan atau menunjukkan di mana fungsi WinHttpQueryHeaders harus mencari informasi tersebut.

WINHTTP_QUERY_FLAG_NUMBER

Mengembalikan data sebagai angka 32-bit untuk header yang nilainya adalah angka, seperti kode status.

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

Kueri hanya meminta header.

WINHTTP_QUERY_FLAG_SYSTEMTIME

Mengembalikan nilai header sebagai struktur SYSTEMTIME , yang tidak mengharuskan aplikasi mengurai data. Gunakan untuk header yang nilainya adalah string tanggal/waktu, seperti "Last-Modified-Time".

WINHTTP_QUERY_FLAG_TRAILERS

Diperkenalkan dalam Windows 11, versi 21H2 (10.0; Build 22000). Kueri menanggapi trailer. Sebelum mengkueri ekor respons, Anda harus memanggil WinHttpReadData hingga menampilkan pembacaan 0 byte.

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Diperkenalkan dalam Windows 11, versi 21H2 (10.0; Build 22000). Secara default, WinHttpQueryHeaders melakukan konversi Unicode sebelum mengembalikan header yang dikueri. Jika bendera ini diatur, WinHttp mengembalikan header ke pemanggil tanpa melakukan konversi ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP, Windows 2000 Professional dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003, Windows 2000 Server dengan SP3 [hanya aplikasi desktop]
Header
Winhttp.h

Lihat juga