enumerasi HTTP_REQUEST_PROPERTY (http.h)

Enumerasi HTTP_REQUEST_PROPERTY menentukan properti yang dapat Anda konfigurasi untuk dikueri atau diatur oleh HTTP Server API berdasarkan permintaan.

Syntax

typedef enum _HTTP_REQUEST_PROPERTY {
  HttpRequestPropertyIsb,
  HttpRequestPropertyTcpInfoV0,
  HttpRequestPropertyQuicStats,
  HttpRequestPropertyTcpInfoV1,
  HttpRequestPropertySni,
  HttpRequestPropertyStreamError,
  HttpRequestPropertyWskApiTimings,
  HttpRequestPropertyQuicApiTimings,
  HttpRequestPropertyQuicStatsV2,
  HttpRequestPropertyQuicStreamStats,
  HttpRequestPropertyTcpInfoV2,
  HttpRequestPropertyTlsClientHello,
  HttpRequestPropertyTransportIdleConnectionTimeout,
  HttpRequestPropertyDscpTag,
  HttpRequestPropertyTlsCipherInfo
} HTTP_REQUEST_PROPERTY, *PHTTP_REQUEST_PROPERTY;

Constants

HttpRequestPropertyIsb Tindakan: Kueri. Nilai Input/Output PVOID: ULONG64 Ambil ukuran backlog pengiriman yang ideal untuk permintaan (lihat SIO_WSK_QUERY_IDEAL_SEND_BACKLOG).
HttpRequestPropertyTcpInfoV0 Tindakan: Kueri. Nilai Input/Output PVOID: TCP_INFO_v0 Ambil statistik TCP_INFO_v0 untuk permintaan. Menggunakan parameter Kualifikasi .
HttpRequestPropertyQuicStats Tindakan: Kueri. Nilai Input/Output PVOID: QUIC_STATISTICS Ambil statistik QUIC_STATISTICS untuk permintaan. Menggunakan parameter Kualifikasi .
HttpRequestPropertyTcpInfoV1 Tindakan: Kueri. Nilai Input/Output PVOID: TCP_INFO_v1 Ambil statistik TCP_INFO_v1 untuk permintaan. Menggunakan parameter Kualifikasi .
HttpRequestPropertySni Tindakan: Kueri. Nilai Input/Output PVOID: HTTP_REQUEST_PROPERTY_SNI Ambil Indikasi Nama Server untuk koneksi TLS permintaan, dalam HTTP_REQUEST_PROPERTY_SNI.
HttpRequestPropertyStreamError Tindakan: Atur. Nilai Input/Output PVOID: HTTP_REQUEST_PROPERTY_STREAM_ERROR Atur struct HTTP_REQUEST_PROPERTY_STREAM_ERROR (HTTP/2 atau HTTP/3) pada permintaan. Struktur HTTP_REQUEST_PROPERTY_STREAM_ERROR berisi data konfigurasi untuk properti ini.
HttpRequestPropertyWskApiTimings Tindakan: Kueri. Nilai Input/Output PVOID: HTTP_WSK_API_TIMINGS Ambil statistik HTTP_WSK_API_TIMINGS untuk permintaan. Hanya digunakan untuk permintaan non-QUIC (HTTP/1.1, HTTP/2). Properti ini memerlukan konfigurasi tambahan untuk mengaktifkan penggunaannya; lihat Komentar.
HttpRequestPropertyQuicApiTimings Tindakan: Kueri. Nilai Input/Output PVOID: HTTP_QUIC_API_TIMINGS Ambil statistik HTTP_QUIC_API_TIMINGS untuk permintaan. Digunakan hanya untuk permintaan HTTP/3. Properti ini memerlukan konfigurasi tambahan untuk mengaktifkan penggunaannya; lihat Komentar.
HttpRequestPropertyQuicStatsV2 Tindakan: Kueri. Nilai Input/Output PVOID: QUIC_STATISTICS_V2 Ambil statistik QUIC_STATISTICS_V2 untuk permintaan. Menggunakan parameter Kualifikasi .
HttpRequestPropertyQuicStreamStats Tindakan: Kueri. Nilai Input/Output PVOID: QUIC_STREAM_STATISTICS Ambil statistik QUIC_STREAM_STATISTICS untuk permintaan.
HttpRequestPropertyTcpInfoV2 Tindakan: Kueri. Nilai Input/Output PVOID: TCP_INFO_v2 Ambil statistik TCP_INFO_v2 yang diperluas untuk permintaan. Menggunakan parameter Kualifikasi .
HttpRequestPropertyTlsClientHello Tindakan: Kueri. Nilai Input/Output PVOID: BYTE[] Ambil konten pesan Halo Klien TLS yang dikirim oleh klien di awal koneksi untuk permintaan tersebut. Properti ini memerlukan konfigurasi tambahan untuk mengaktifkan penggunaannya; lihat Komentar.
HttpRequestPropertyTransportIdleConnectionTimeout Tindakan: Atur. Nilai Input/Output PVOID: USHORT Atur batas waktu dalam detik jika permintaan ini diam.
HttpRequestPropertyDscpTag Tindakan: Atur. Nilai Input/Output PVOID: BYTE Atur tag titik kode layanan diferensiasi (DSCP) ke nilai BYTE yang disediakan pada semua paket yang dikirim dalam respons terhadap permintaan ini. Ini adalah nilai 6-bit secara internal, sehingga nilai maksimumnya 0x3F.
HttpRequestPropertyTlsCipherInfo Tindakan: Kueri. Nilai Input/Output PVOID: SecPkgContext_CipherInfo Ambil rangkaian sandi dan parameter yang dipilih untuk koneksi ini di jabat tangan TLS.

Komentar

Jenis enumerasi HTTP_REQUEST_PROPERTY digunakan untuk mengatur atau mengkueri konfigurasi berdasarkan permintaan. Anggota enumerasi ini bersama dengan struktur konfigurasi terkait digunakan oleh HttpSetRequestProperty untuk menentukan parameter konfigurasi.

HttpRequestPropertyWskApiTimings dan HttpRequestPropertyQuicApiTimings. Properti ini mengharuskan HKLM\System\CurrentControlSet\Services\Http\Parameters:EnableExtendedEvents nilai registri diatur ke 0x1 sebelum memulai atau memulai ulang layanan HTTP.

HttpRequestPropertyTlsClientHello. Untuk mengonfirmasi ketersediaan fitur ini, panggil HttpIsFeatureSupported dan teruskanHttpFeatureCacheTlsClientHello. Karena penembolokan TLS Client Hello mahal per koneksi, untuk mengaktifkan fitur ini, Anda harus memanggil HttpSetServiceConfiguration dengan struktur HTTP_SERVICE_CONFIG_SSL_SET di pConfigInformation dengan set HTTP_SERVICE_CONFIG_SSL_FLAG_ENABLE_CACHE_CLIENT_HELLO (lihat HTTP_SERVICE_CONFIG_SSL_PARAM). Karena Hello Klien TLS tidak memiliki panjang tetap, properti ini dapat dikueri dengan penunjuk buffer NULL untuk menentukan ukuran buffer yang Anda butuhkan; lihat contoh di HttpQueryRequestProperty untuk detailnya.

Persyaratan

Persyaratan	Nilai
Header	http.h

Lihat juga

HttpSetRequestProperty