Compartilhar via

HTTP_REQUEST_PROPERTY enumeração (http.h)

A enumeração HTTP_REQUEST_PROPERTY define as propriedades que você pode configurar para serem consultadas ou definidas pela API do Servidor HTTP em uma solicitação.

Sintaxe

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
Ação: Consulta.
Valor de entrada/saída PVOID: ULONG64

Recupere o tamanho ideal da lista de pendências de envio para uma solicitação (consulte SIO_WSK_QUERY_IDEAL_SEND_BACKLOG).
HttpRequestPropertyTcpInfoV0
Ação: Consulta.
Valor de entrada/saída PVOID: TCP_INFO_v0

Recupere as estatísticas de TCP_INFO_v0 para uma solicitação. Usa o parâmetro Qualificador .
HttpRequestPropertyQuicStats
Ação: Consulta.
Valor de entrada/saída PVOID: QUIC_STATISTICS

Recupere as estatísticas de QUIC_STATISTICS para uma solicitação. Usa o parâmetro Qualificador .
HttpRequestPropertyTcpInfoV1
Ação: Consulta.
Valor de entrada/saída PVOID: TCP_INFO_v1

Recupere as estatísticas de TCP_INFO_v1 para uma solicitação. Usa o parâmetro Qualificador .
HttpRequestPropertySni
Ação: Consulta.
Valor de entrada/saída PVOID: HTTP_REQUEST_PROPERTY_SNI

Recupere a Indicação de Nome do Servidor para a conexão TLS da solicitação, em um HTTP_REQUEST_PROPERTY_SNI.
HttpRequestPropertyStreamError
Ação: Definir.
Valor de entrada/saída PVOID: HTTP_REQUEST_PROPERTY_STREAM_ERROR

Defina um struct (HTTP/2 ou HTTP/3) HTTP_REQUEST_PROPERTY_STREAM_ERROR em uma solicitação. A estrutura HTTP_REQUEST_PROPERTY_STREAM_ERROR contém os dados de configuração dessa propriedade.
HttpRequestPropertyWskApiTimings
Ação: Consulta.
Valor de entrada/saída PVOID: HTTP_WSK_API_TIMINGS

Recupere as estatísticas de HTTP_WSK_API_TIMINGS para uma solicitação. Usado apenas para solicitações não QUIC (HTTP/1.1, HTTP/2). Essa propriedade requer configuração adicional para habilitar seu uso; consulte Comentários.
HttpRequestPropertyQuicApiTimings
Ação: Consulta.
Valor de entrada/saída PVOID: HTTP_QUIC_API_TIMINGS

Recupere as estatísticas de HTTP_QUIC_API_TIMINGS para uma solicitação. Usado somente para solicitações HTTP/3. Essa propriedade requer configuração adicional para habilitar seu uso; consulte Comentários.
HttpRequestPropertyQuicStatsV2
Ação: Consulta.
Valor de entrada/saída PVOID: QUIC_STATISTICS_V2

Recupere as estatísticas de QUIC_STATISTICS_V2 para uma solicitação. Usa o parâmetro Qualificador .
HttpRequestPropertyQuicStreamStats
Ação: Consulta.
Valor de entrada/saída PVOID: QUIC_STREAM_STATISTICS

Recupere as estatísticas de QUIC_STREAM_STATISTICS para uma solicitação.
HttpRequestPropertyTcpInfoV2
Ação: Consulta.
Valor de entrada/saída PVOID: TCP_INFO_v2

Recupere estatísticas de TCP_INFO_v2 estendidas para uma solicitação. Usa o parâmetro Qualificador .
HttpRequestPropertyTlsClientHello
Ação: Consulta.
Valor de entrada/saída PVOID: BYTE[]

Recupere o conteúdo da mensagem Hello do cliente TLS enviada pelo cliente no início da conexão para essa solicitação. Essa propriedade requer configuração adicional para habilitar seu uso; consulte Comentários.
HttpRequestPropertyTransportIdleConnectionTimeout
Ação: Definir.
Valor de entrada/saída PVOID: USHORT

Defina um tempo limite em segundos para se essa solicitação ficar ociosa.
HttpRequestPropertyDscpTag
Ação: Definir.
Valor de entrada/saída PVOID: BYTE

Defina a marca DSCP (ponto de código de serviços diferenciados) como o valor BYTE fornecido em todos os pacotes enviados na resposta a essa solicitação. Esse é um valor de 6 bits internamente, portanto, o valor máximo é 0x3F.
HttpRequestPropertyTlsCipherInfo
Ação: Consulta.
Valor de entrada/saída PVOID: SecPkgContext_CipherInfo

Recupere o conjunto de criptografias e os parâmetros selecionados para essa conexão no handshake do TLS.

Observações

Os tipos de enumeração HTTP_REQUEST_PROPERTY são usados para definir ou consultar as configurações em uma solicitação. Um membro dessa enumeração junto com a estrutura de configuração associada é usado por HttpSetRequestProperty para definir os parâmetros de configuração.

HttpRequestPropertyWskApiTimings e HttpRequestPropertyQuicApiTimings. Essas propriedades exigem que o valor do HKLM\System\CurrentControlSet\Services\Http\Parameters:EnableExtendedEvents Registro seja definido como 0x1 antes de iniciar ou reiniciar o serviço HTTP.

HttpRequestPropertyTlsClientHello. Para confirmar a disponibilidade desse recurso, chame HttpIsFeatureSupported e passe HttpFeatureCacheTlsClientHello. Como o cache do Cliente TLS Hello é caro por conexão, para habilitar esse recurso, você precisará chamar HttpSetServiceConfiguration com um struct HTTP_SERVICE_CONFIG_SSL_SET em pConfigInformation com HTTP_SERVICE_CONFIG_SSL_FLAG_ENABLE_CACHE_CLIENT_HELLO definido (consulte HTTP_SERVICE_CONFIG_SSL_PARAM). Como um Hello do cliente TLS não tem um comprimento fixo, essa propriedade pode ser consultada com um ponteiro de buffer NULL para determinar o tamanho de um buffer necessário; consulte o exemplo em HttpQueryRequestProperty para obter detalhes.

Requirements

Requirement Value
Header http.h

Consulte também

HttpSetRequestProperty

  • Last updated on