enumeração HTTP_HEADER_ID (http.h)

  • Artigo

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