enumeración HTTP_HEADER_ID (http.h)

  • Artículo

El tipo de enumeración HTTP_HEADER_ID enumera los encabezados conocidos para las solicitudes y respuestas HTTP, y asocia un índice de matriz a cada encabezado de este tipo. Se usa para ajustar el tamaño y acceder a los miembros de la matriz KnownHeaders de las estructuras de HTTP_REQUEST_HEADERS y 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
Se usa para especificar el comportamiento de almacenamiento en caché a lo largo de la cadena de solicitud o respuesta, reemplazando el algoritmo de almacenamiento en caché predeterminado.
HttpHeaderConnection
Valor: 1
Permite al remitente especificar las opciones que se desean para esa conexión concreta. Estos se usan solo para una sola conexión y los servidores proxy no deben comunicarse a través de más conexiones.
HttpHeaderDate
Valor: 2
La fecha es un campo de encabezado general que indica la hora en que se envió la solicitud o respuesta.
HttpHeaderKeepAlive
Valor: 3
Basado en el elemento XML keepalive (consulte RFC 2518, sección 12.12.1, página 66); una lista de URI incluidos en KeepAlive
el encabezado debe ser "activo" una vez copiados
(movido) al destino.
HttpHeaderPragma
Valor: 4
Se usa para incluir directivas opcionales específicas de la implementación que se pueden aplicar a cualquier destinatario a lo largo de la cadena de solicitud y respuesta.
HttpHeaderTrailer
Valor: 5
Indica que los campos de encabezado especificados están presentes en el finalizador de un mensaje codificado con codificación de transferencia fragmentada.
HttpHeaderTransferEncoding
Valor: 6
Indica lo que, si existe, se han aplicado transformaciones al cuerpo del mensaje en tránsito.
HttpHeaderUpgrade
Valor: 7
Permite al cliente especificar uno o más protocolos de comunicación que prefiera usar si el servidor puede cumplir.
HttpHeaderVia
Valor: 8
El campo Encabezado Via indica la ruta de acceso realizada por la solicitud.
HttpHeaderWarning
Valor: 9
Se trata de un encabezado de respuesta que contiene el código de advertencia de 3 dígitos junto con la frase de motivo.
HttpHeaderAllow
Valor: 10
Listas el conjunto de métodos admitidos por el recurso identificado por el URI de solicitud.
HttpHeaderContentLength
Valor: 11
Tamaño del cuerpo del mensaje en bytes decimales.
HttpHeaderContentType
Valor: 12
Tipo de medio del cuerpo del mensaje.
HttpHeaderContentEncoding
Valor: 13
Esquema de codificación para el cuerpo del mensaje.
HttpHeaderContentLanguage
Valor: 14
Proporciona el lenguaje natural del público previsto.
HttpHeaderContentLocation
Valor: 15
Ubicación del recurso de la entidad incluida en el mensaje cuando esa entidad es accesible desde una ubicación independiente del URI del recurso solicitado.
HttpHeaderContentMd5
Valor: 16
Resumen MD5 del cuerpo de la entidad que se usa para proporcionar una comprobación de integridad de mensajes de un extremo a otro (MIC) del cuerpo de la entidad.
HttpHeaderContentRange
Valor: 17
El encabezado de intervalo de contenido se envía con un cuerpo de entidad parcial para especificar dónde se debe aplicar el cuerpo parcial en el cuerpo de la entidad completa.
HttpHeaderExpires
Valor: 18
Fecha y hora después de la cual expira el contenido del mensaje.
HttpHeaderLastModified
Valor: 19
Indica la fecha y hora en que el servidor de origen cree que la variante se modificó por última vez.
HttpHeaderAccept
Valor: 20
Se usa con los métodos INVITE, OPTIONS y REGISTER para indicar qué tipos de medios son aceptables en la respuesta.
HttpHeaderAcceptCharset
Valor: 21
Indica los juegos de caracteres que son aceptables para la respuesta.
HttpHeaderAcceptEncoding
Valor: 22
Codificaciones de contenido que son aceptables en la respuesta.
HttpHeaderAcceptLanguage
Valor: 23
Usado por el cliente para indicar al servidor qué idioma prefiere recibir frases de motivo, descripciones de sesión o respuestas de estado.
HttpHeaderAuthorization
Valor: 24
El agente de usuario se puede autenticar con un servidor enviando el campo de encabezado de solicitud de autorización con la solicitud. El campo contiene las credenciales del dominio que solicita el usuario.
HttpHeaderCookie
Valor: 25
El encabezado de solicitud de cookie contiene datos usados para mantener el estado de cliente con el servidor. Los datos de cookies se obtienen de una respuesta enviada con HttpHeaderSetCookie.
HttpHeaderExpect
Valor: 26
Indica los comportamientos de servidor específicos que requiere el cliente.
HttpHeaderFrom
Valor: 27
El campo Encabezado From especifica el iniciador de la solicitud SIP o el mensaje de respuesta.
HttpHeaderHost
Valor: 28
Especifica el host de Internet y el número de puerto del recurso solicitado. Esto se obtiene del URI original proporcionado por el usuario o el recurso de referencia.
HttpHeaderIfMatch
Valor: 29
El campo de encabezado de solicitud If-Match se usa con un método para que sea condicional. Un cliente que tenga una o varias entidades obtenidas anteriormente del recurso puede comprobar que una de esas entidades está actualizada mediante la inclusión de una lista de sus etiquetas de entidad asociadas en el campo de encabezado If-Match.
HttpHeaderIfModifiedSince
Valor: 30
El campo de encabezado de solicitud If-Modified-Since se usa con un método para que sea condicional. Si la variante solicitada no se ha modificado desde el momento especificado en este campo, no se devuelve una entidad desde el servidor; en su lugar, se devuelve una respuesta 304 (no modificada) sin ningún cuerpo del mensaje.
HttpHeaderIfNoneMatch
Valor: 31
El campo de encabezado de solicitud If-None-Match se usa con un método para realizar
condicional. Cuando un cliente ha obtenido una o varias entidades de un recurso, puede comprobar que ninguna de esas entidades es
actual mediante la inclusión de una lista de sus etiquetas de entidad asociadas en
Campo de encabezado If-None-Match. El propósito de esta característica es permitir
actualizaciones eficaces de la información almacenada en caché con una cantidad mínima de
sobrecarga de transacciones y para evitar un método como PUT
de modificar accidentalmente un recurso existente cuando el cliente
cree que el recurso no existe.
HttpHeaderIfRange
Valor: 32
Si un cliente tiene una copia parcial de una entidad en su memoria caché y desea
para obtener una copia actualizada de toda la entidad,
puede usar el encabezado If-Range. Informalmente, su significado es : "si la entidad no cambia, envíe
me faltan las partes; de lo contrario, envíeme todo el nuevo
entity."
HttpHeaderIfUnmodifiedSince
Valor: 33
El campo If-Unmodified-Since request-header se usa con un método para
haga que sea condicional. Si el recurso solicitado no se ha modificado
desde la hora especificada en este campo, el servidor realiza el
operación solicitada como si el encabezado If-Unmodified-Since no fuera
presente, pero

si se ha modificado el recurso solicitado,
el servidor devuelve
un error 412 (error de condición previa).
HttpHeaderMaxForwards
Valor: 34
Número máximo de servidores proxy o puertas de enlace que pueden reenviar la solicitud.
HttpHeaderProxyAuthorization
Valor: 35
El cliente usa este campo de encabezado para identificarse con un proxy.
HttpHeaderReferer
Valor: 36
Permite que el cliente especifique, para la ventaja del servidor, la dirección (URI) del recurso desde el que se obtuvo el URI de solicitud.
HttpHeaderRange
Valor: 37
Permite a un cliente solicitar una parte de una entidad en lugar de todo.
HttpHeaderTe
Valor: 38
Este campo de encabezado contiene el destinatario del mensaje de solicitud o respuesta SIP.
HttpHeaderTranslate
Valor: 39
Permite al cliente especificar si quiere la representación de origen o la interpretación mediante programación del contenido solicitado.
HttpHeaderUserAgent
Valor: 40
Indica qué codificación de transferencia de extensión acepta el cliente en la respuesta y si el cliente acepta o no campos de finalizador en una codificación de transferencia fragmentada.
HttpHeaderRequestMaximum
Valor: 41
No es un valor que designe realmente un encabezado; en su lugar, se usa para contar los encabezados de solicitud enumerados.
HttpHeaderAcceptRanges
Valor: 20
Permite al servidor indicar su aceptación de solicitudes de intervalo para un recurso.
HttpHeaderAge
Valor: 21
Transmite la estimación del remitente de la cantidad de tiempo desde que se generó la respuesta (o su revalidación) en el servidor de origen.
HttpHeaderEtag
Valor: 22
Proporciona el valor actual de la etiqueta de entidad para la variante solicitada.
HttpHeaderLocation
Valor: 23
Se usa para redirigir al destinatario a una ubicación distinta del URI de solicitud para completar la solicitud o la identificación de un nuevo recurso.
HttpHeaderProxyAuthenticate
Valor: 24
Campo de respuesta que se debe incluir como parte de la respuesta 407. El campo incluye el esquema de autenticación y los parámetros que se aplican al proxy para este URI de solicitud.
HttpHeaderRetryAfter
Valor: 25
El período de tiempo que se espera que el servicio no esté disponible para el cliente solicitante.
HttpHeaderServer
Valor: 26
Se trata de un campo de encabezado de respuesta que contiene información sobre el servidor que controla la solicitud.
HttpHeaderSetCookie
Valor: 27
El encabezado de respuesta set-cookie contiene datos que se usan para mantener el estado del cliente en futuras solicitudes enviadas con HttpHeaderCookie.
HttpHeaderVary
Valor: 28
Indica el conjunto de campos de encabezado de solicitud que determinan por completo, mientras que la respuesta está actualizada, si se permite que una memoria caché use la respuesta para responder a una solicitud posterior sin revalidación.
HttpHeaderWwwAuthenticate
Valor: 29
El campo de encabezado WWW_Authenticate contiene los esquemas de autenticación y los parámetros aplicables al URI de solicitud.
HttpHeaderResponseMaximum
Valor: 30
No es un valor que designe realmente un encabezado; en su lugar, se usa para contar los encabezados de respuesta enumerados.
HttpHeaderMaximum
Valor: 41
No es un valor que designe realmente un encabezado; en su lugar, se usa para contar todos los encabezados enumerados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado http.h

Consulte también

HTTP_REQUEST_HEADERS

HTTP_RESPONSE_HEADERS