enumeração HTTP_HEADER_ID (http.h)

O tipo de enumeração HTTP_HEADER_ID lista cabeçalhos conhecidos para solicitações e respostas HTTP e associa um índice de matriz a cada cabeçalho desse tipo. Ele é usado para dimensionar e acessar os membros da matriz KnownHeaders das estruturas HTTP_REQUEST_HEADERS e HTTP_RESPONSE_HEADERS .

Syntax

typedef enum _HTTP_HEADER_ID {
  HttpHeaderCacheControl = 0,
  HttpHeaderConnection = 1,
  HttpHeaderDate = 2,
  HttpHeaderKeepAlive = 3,
  HttpHeaderPragma = 4,
  HttpHeaderTrailer = 5,
  HttpHeaderTransferEncoding = 6,
  HttpHeaderUpgrade = 7,
  HttpHeaderVia = 8,
  HttpHeaderWarning = 9,
  HttpHeaderAllow = 10,
  HttpHeaderContentLength = 11,
  HttpHeaderContentType = 12,
  HttpHeaderContentEncoding = 13,
  HttpHeaderContentLanguage = 14,
  HttpHeaderContentLocation = 15,
  HttpHeaderContentMd5 = 16,
  HttpHeaderContentRange = 17,
  HttpHeaderExpires = 18,
  HttpHeaderLastModified = 19,
  HttpHeaderAccept = 20,
  HttpHeaderAcceptCharset = 21,
  HttpHeaderAcceptEncoding = 22,
  HttpHeaderAcceptLanguage = 23,
  HttpHeaderAuthorization = 24,
  HttpHeaderCookie = 25,
  HttpHeaderExpect = 26,
  HttpHeaderFrom = 27,
  HttpHeaderHost = 28,
  HttpHeaderIfMatch = 29,
  HttpHeaderIfModifiedSince = 30,
  HttpHeaderIfNoneMatch = 31,
  HttpHeaderIfRange = 32,
  HttpHeaderIfUnmodifiedSince = 33,
  HttpHeaderMaxForwards = 34,
  HttpHeaderProxyAuthorization = 35,
  HttpHeaderReferer = 36,
  HttpHeaderRange = 37,
  HttpHeaderTe = 38,
  HttpHeaderTranslate = 39,
  HttpHeaderUserAgent = 40,
  HttpHeaderRequestMaximum = 41,
  HttpHeaderAcceptRanges = 20,
  HttpHeaderAge = 21,
  HttpHeaderEtag = 22,
  HttpHeaderLocation = 23,
  HttpHeaderProxyAuthenticate = 24,
  HttpHeaderRetryAfter = 25,
  HttpHeaderServer = 26,
  HttpHeaderSetCookie = 27,
  HttpHeaderVary = 28,
  HttpHeaderWwwAuthenticate = 29,
  HttpHeaderResponseMaximum = 30,
  HttpHeaderMaximum = 41
} HTTP_HEADER_ID, *PHTTP_HEADER_ID;

Constantes


`HttpHeaderCacheControl` Valor: 0 Usado para especificar o comportamento de cache ao longo da cadeia de solicitação ou resposta, substituindo o algoritmo de cache padrão.
`HttpHeaderConnection` Valor: 1 Permite que o remetente especifique as opções desejadas para essa conexão específica. Eles são usados apenas para uma única conexão e não devem ser comunicados por proxies em conexões adicionais.
`HttpHeaderDate` Valor: 2 A Data é um campo de cabeçalho geral que indica a hora em que a solicitação ou resposta foi enviada.
`HttpHeaderKeepAlive` Valor: 3 Com base no elemento XML keepalive (consulte RFC 2518, seção 12.12.1, página 66); uma lista de URIs incluídos no KeepAlive o cabeçalho deve ser "dinâmico" depois de copiado (movido) para o destino.
`HttpHeaderPragma` Valor: 4 Usado para incluir diretivas opcionais específicas da implementação que podem se aplicar a qualquer destinatário ao longo da cadeia de solicitação/resposta.
`HttpHeaderTrailer` Valor: 5 Indica que os campos de cabeçalho especificados estão presentes no trailer de uma mensagem codificada com codificação de transferência em partes.
`HttpHeaderTransferEncoding` Valor: 6 Indica o que, se houver, transformações foram aplicadas ao corpo da mensagem em trânsito.
`HttpHeaderUpgrade` Valor: 7 Permite que o cliente especifique um ou mais outros protocolos de comunicação que ele prefere usar se o servidor puder cumprir.
`HttpHeaderVia` Valor: 8 O campo de cabeçalho Via indica o caminho tomado pela solicitação.
`HttpHeaderWarning` Valor: 9 Esse é um cabeçalho de resposta que contém o código de aviso de três dígitos junto com a frase do motivo.
`HttpHeaderAllow` Valor: 10 Listas o conjunto de métodos com suporte pelo recurso identificado pelo Request-URI.
`HttpHeaderContentLength` Valor: 11 O tamanho do corpo da mensagem em bytes decimais.
`HttpHeaderContentType` Valor: 12 O tipo de mídia do corpo da mensagem.
`HttpHeaderContentEncoding` Valor: 13 O esquema de codificação para o corpo da mensagem.
`HttpHeaderContentLanguage` Valor: 14 Fornece a linguagem natural do público-alvo pretendido.
`HttpHeaderContentLocation` Valor: 15 Local do recurso para a entidade colocada na mensagem quando essa entidade está acessível de um local separado do URI do recurso solicitado.
`HttpHeaderContentMd5` Valor: 16 Um resumo MD5 do corpo da entidade usado para fornecer integridade de mensagem de ponta a ponta marcar (MIC) do corpo da entidade.
`HttpHeaderContentRange` Valor: 17 O cabeçalho do intervalo de conteúdo é enviado com um corpo de entidade parcial para especificar onde, no corpo completo da entidade, o corpo parcial deve ser aplicado.
`HttpHeaderExpires` Valor: 18 A data e a hora após a qual o conteúdo da mensagem expira.
`HttpHeaderLastModified` Valor: 19 Indica a data e a hora em que o servidor de origem acredita que a variante foi modificada pela última vez.
`HttpHeaderAccept` Valor: 20 Usado com os métodos INVITE, OPTIONS e REGISTER para indicar quais tipos de mídia são aceitáveis na resposta.
`HttpHeaderAcceptCharset` Valor: 21 Indica os conjuntos de caracteres aceitáveis para a resposta.
`HttpHeaderAcceptEncoding` Valor: 22 As codificações de conteúdo aceitáveis na resposta.
`HttpHeaderAcceptLanguage` Valor: 23 Usado pelo cliente para indicar ao servidor qual idioma ele prefere receber frases de motivo, descrições de sessão ou respostas status.
`HttpHeaderAuthorization` Valor: 24 O agente de usuário pode se autenticar com um servidor enviando o campo cabeçalho de solicitação de autorização com a solicitação. O campo contém as credenciais para o domínio que o usuário está solicitando.
`HttpHeaderCookie` Valor: 25 O cabeçalho de solicitação de cookie contém dados usados para manter o estado do cliente com o servidor. Os dados de cookie são obtidos de uma resposta enviada com HttpHeaderSetCookie.
`HttpHeaderExpect` Valor: 26 Indica os comportamentos específicos do servidor exigidos pelo cliente.
`HttpHeaderFrom` Valor: 27 O campo de cabeçalho From especifica o iniciador da solicitação SIP ou da mensagem de resposta.
`HttpHeaderHost` Valor: 28 Especifica o host da Internet e o número da porta do recurso solicitado. Isso é obtido do URI original fornecido pelo usuário ou do recurso de referência.
`HttpHeaderIfMatch` Valor: 29 O campo de cabeçalho de solicitação If-Match é usado com um método para torná-lo condicional. Um cliente que tem uma ou mais entidades obtidas anteriormente do recurso pode verificar se uma dessas entidades está atual, incluindo uma lista de suas marcas de entidade associadas no campo de cabeçalho If-Match.
`HttpHeaderIfModifiedSince` Valor: 30 O campo de cabeçalho de solicitação If-Modified-Since é usado com um método para torná-lo condicional. Se a variante solicitada não tiver sido modificada desde o tempo especificado neste campo, uma entidade não será retornada do servidor; Em vez disso, uma resposta 304 (não modificada) é retornada sem nenhum corpo da mensagem.
`HttpHeaderIfNoneMatch` Valor: 31 O campo if-none-match request-header é usado com um método para fazer condicional. Quando um cliente tiver obtido uma ou mais entidades de um recurso, ele poderá verificar se nenhuma dessas entidades está atual, incluindo uma lista de suas marcas de entidade associadas no Campo de cabeçalho If-None-Match. A finalidade desse recurso é permitir atualizações eficientes de informações armazenadas em cache com uma quantidade mínima de sobrecarga de transação e para evitar um método como PUT de modificar inadvertidamente um recurso existente quando o cliente acredita que o recurso não existe.
`HttpHeaderIfRange` Valor: 32 Se um cliente tiver uma cópia parcial de uma entidade em seu cache e desejar para obter uma cópia atualizada de toda a entidade, ela pode usar o cabeçalho If-Range. Informalmente, seu significado é: "se a entidade estiver inalterada, envie me as partes que eu estou faltando; caso contrário, envie-me todo o novo entidade."
`HttpHeaderIfUnmodifiedSince` Valor: 33 O campo If-Unmodified-Since request-header é usado com um método para torná-lo condicional. Se o recurso solicitado não tiver sido modificado desde o tempo especificado neste campo, o servidor executa o operação solicitada como se o cabeçalho If-Unmodified-Since não fosse presente, mas se o recurso solicitado tiver sido modificado, o servidor retorna um erro 412 (Falha na pré-condição).
`HttpHeaderMaxForwards` Valor: 34 O número máximo de proxies ou gateways que podem encaminhar a solicitação.
`HttpHeaderProxyAuthorization` Valor: 35 Esse campo de cabeçalho é usado pelo cliente para se identificar com um proxy.
`HttpHeaderReferer` Valor: 36 Permite que o cliente especifique, para o benefício do servidor, o endereço (URI) do recurso do qual o Request-URI foi obtido.
`HttpHeaderRange` Valor: 37 Permite que um cliente solicite uma parte de uma entidade em vez de toda.
`HttpHeaderTe` Valor: 38 Esse campo de cabeçalho contém o destinatário da solicitação SIP ou da mensagem de resposta.
`HttpHeaderTranslate` Valor: 39 Permite que o cliente especifique se deseja a representação de origem ou a interpretação programática do conteúdo solicitado.
`HttpHeaderUserAgent` Valor: 40 Indica quais codificações de transferência de extensão o cliente aceita na resposta e se o cliente aceita ou não campos de trailer em uma codificação de transferência em partes.
`HttpHeaderRequestMaximum` Valor: 41 Não é um valor que realmente designa um cabeçalho; em vez disso, ele é usado para contar os cabeçalhos de solicitação enumerados.
`HttpHeaderAcceptRanges` Valor: 20 Permite que o servidor indique sua aceitação de solicitações de intervalo para um recurso.
`HttpHeaderAge` Valor: 21 Transmite a estimativa do remetente da quantidade de tempo desde que a resposta (ou sua revalidação) foi gerada no servidor de origem.
`HttpHeaderEtag` Valor: 22 Fornece o valor atual da marca de entidade para a variante solicitada.
`HttpHeaderLocation` Valor: 23 Usado para redirecionar o destinatário para um local diferente do Request-URI para conclusão da solicitação ou identificação de um novo recurso.
`HttpHeaderProxyAuthenticate` Valor: 24 O campo de resposta que deve ser incluído como parte da resposta 407. O campo inclui o esquema de autenticação e os parâmetros que se aplicam ao proxy para esse Request-URI.
`HttpHeaderRetryAfter` Valor: 25 Espera-se que o período de tempo que o serviço esteja indisponível para o cliente solicitante.
`HttpHeaderServer` Valor: 26 Esse é um campo de cabeçalho de resposta que contém informações sobre o servidor que está tratando a solicitação.
`HttpHeaderSetCookie` Valor: 27 O cabeçalho de resposta set-cookie contém dados usados para manter o estado do cliente em solicitações futuras enviadas com HttpHeaderCookie.
`HttpHeaderVary` Valor: 28 Indica o conjunto de campos de cabeçalho de solicitação que determina totalmente, enquanto a resposta é recente, se um cache tem permissão para usar a resposta para responder a uma solicitação subsequente sem revalidação.
`HttpHeaderWwwAuthenticate` Valor: 29 O campo de cabeçalho WWW_Authenticate contém os esquemas de autenticação e os parâmetros aplicáveis ao Request-URI.
`HttpHeaderResponseMaximum` Valor: 30 Não é um valor que realmente designa um cabeçalho; em vez disso, ele é usado para contar os cabeçalhos de resposta enumerados.
`HttpHeaderMaximum` Valor: 41 Não é um valor que realmente designa um cabeçalho; em vez disso, ele é usado para contar todos os cabeçalhos enumerados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	http.h

Confira também

HTTP_REQUEST_HEADERS

HTTP_RESPONSE_HEADERS

Comentários

Esta página foi útil?

Last updated on 2023-08-24