Marcas de información de consulta (Wininet.h)

Las listas siguientes contienen los atributos y modificadores usados por HttpQueryInfo y QueryInfo.

HttpQueryInfo (o QueryInfo) usan las marcas de atributo para indicar qué datos se van a recuperar. La mayoría de las marcas de atributo se asignan directamente a un encabezado HTTP específico. También hay algunas marcas especiales, como HTTP_QUERY_RAW_HEADERS, que no están relacionadas con un encabezado específico.

HTTP_QUERY_ACCEPT

24

Recupera los tipos de medios aceptables para la respuesta.

HTTP_QUERY_ACCEPT_CHARSET

25

Recupera los juegos de caracteres aceptables para la respuesta.

HTTP_QUERY_ACCEPT_ENCODING

26

Recupera los valores aceptables de codificación de contenido para la respuesta.

HTTP_QUERY_ACCEPT_LANGUAGE

27

Recupera los lenguajes naturales aceptables para la respuesta.

HTTP_QUERY_ACCEPT_RANGES

42

Recupera los tipos de solicitudes de intervalo que se aceptan para un recurso.

HTTP_QUERY_AGE

48

Recupera el campo Encabezado de respuesta Age, que contiene la estimación del remitente de la cantidad de tiempo desde que se generó la respuesta en el servidor de origen.

HTTP_QUERY_ALLOW

7

Recibe los verbos HTTP admitidos por el servidor.

HTTP_QUERY_AUTHORIZATION

28

Recupera las credenciales de autorización usadas para una solicitud.

HTTP_QUERY_CACHE_CONTROL

49

Recupera las directivas de control de caché.

HTTP_QUERY_CONNECTION

23

Recupera las opciones especificadas para una conexión determinada y no debe comunicarse mediante servidores proxy a través de más conexiones.

HTTP_QUERY_CONTENT_BASE

50

Recupera el URI base (identificador uniforme de recursos) para resolver direcciones URL relativas dentro de la entidad.

HTTP_QUERY_CONTENT_DESCRIPTION

4

Obsoleto. Solo se mantiene para la compatibilidad de aplicaciones heredadas.

HTTP_QUERY_CONTENT_DISPOSITION

47

Obsoleto. Solo se mantiene para la compatibilidad de aplicaciones heredadas.

HTTP_QUERY_CONTENT_ENCODING

29

Recupera cualquier codificación de contenido adicional que se haya aplicado a todo el recurso.

HTTP_QUERY_CONTENT_ID

3

Recupera la identificación del contenido.

HTTP_QUERY_CONTENT_LANGUAGE

6

Recupera el idioma en el que se encuentra el contenido.

HTTP_QUERY_CONTENT_LENGTH

5

Recupera el tamaño del recurso, en bytes.

HTTP_QUERY_CONTENT_LOCATION

51

Recupera la ubicación del recurso de la entidad incluida en el mensaje.

HTTP_QUERY_CONTENT_MD5

52

Recupera un resumen MD5 del cuerpo de la entidad con el fin de proporcionar una comprobación de integridad de mensajes de un extremo a otro (MIC) para el cuerpo de la entidad. Para obtener más información, vea RFC1864, El campo de encabezado Content-MD5, en https://ftp.isi.edu/in-notes/rfc1864.txt.

HTTP_QUERY_CONTENT_RANGE

53

Recupera la ubicación en el cuerpo de la entidad completa donde se debe insertar el cuerpo de la entidad parcial y el tamaño total del cuerpo de la entidad completa.

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2

Recibe la codificación de contenido adicional que se ha aplicado al recurso.

HTTP_QUERY_CONTENT_TYPE

1

Recibe el tipo de contenido del recurso (por ejemplo, texto/html).

HTTP_QUERY_COOKIE

44

Recupera las cookies asociadas a la solicitud.

HTTP_QUERY_COST

15

Ya no se admite.

HTTP_QUERY_CUSTOM

65535

Hace que HttpQueryInfo busque el nombre de encabezado especificado en lpvBuffer y almacene los datos de encabezado en lpvBuffer.

HTTP_QUERY_DATE

9

Recibe la fecha y hora en que se originó el mensaje.

HTTP_QUERY_DERIVED_FROM

14

Ya no se admite.

HTTP_QUERY_ECHO_HEADERS

73

No implementado actualmente.

HTTP_QUERY_ECHO_HEADERS_CRLF

74

No implementado actualmente.

HTTP_QUERY_ECHO_REPLY

72

No implementado actualmente.

HTTP_QUERY_ECHO_REQUEST

71

No implementado actualmente.

HTTP_QUERY_ETAG

54

Recupera la etiqueta de entidad para la entidad asociada.

HTTP_QUERY_EXPECT

68

Recupera el encabezado Expect, que indica si la aplicación cliente debe esperar 100 respuestas de la serie.

HTTP_QUERY_EXPIRES

10

Recibe la fecha y hora después de la cual el recurso debe considerarse obsoleto.

HTTP_QUERY_FORWARDED

30

Obsoleto. Solo se mantiene para la compatibilidad de aplicaciones heredadas.

HTTP_QUERY_FROM

31

Recupera la dirección de correo electrónico del usuario humano que controla el agente de usuario solicitante si se da el encabezado From.

HTTP_QUERY_HOST

55

Recupera el host de Internet y el número de puerto del recurso que se solicita.

HTTP_QUERY_IF_MATCH

56

Recupera el contenido del campo If-Match encabezado de solicitud.

HTTP_QUERY_IF_MODIFIED_SINCE

32

Recupera el contenido del encabezado If-Modified-Since.

HTTP_QUERY_IF_NONE_MATCH

57

Recupera el contenido del campo de encabezado de solicitud If-None-Match.

HTTP_QUERY_IF_RANGE

58

Recupera el contenido del campo If-Range encabezado de solicitud. Este encabezado permite a la aplicación cliente comprobar que la entidad relacionada con una copia parcial de la entidad en la caché de la aplicación cliente no se ha actualizado. Si la entidad no se ha actualizado, envíe los elementos que falta la aplicación cliente. Si la entidad se ha actualizado, envíe toda la entidad actualizada.

HTTP_QUERY_IF_UNMODIFIED_SINCE

59

Recupera el contenido del campo If-Unmodified-Since request-header.

HTTP_QUERY_LAST_MODIFIED

11

Recibe la fecha y hora en que el servidor cree que el recurso se modificó por última vez.

HTTP_QUERY_LINK

16

Obsoleto. Solo se mantiene para la compatibilidad de aplicaciones heredadas.

HTTP_QUERY_LOCATION

33

Recupera el identificador uniforme de recursos (URI) absoluto usado en un encabezado de respuesta de ubicación.

HTTP_QUERY_MAX

78

No es una marca de consulta. Indica el valor máximo de un valor HTTP_QUERY_*.

HTTP_QUERY_MAX_FORWARDS

60

Recupera el número de servidores proxy o puertas de enlace que pueden reenviar la solicitud al siguiente servidor entrante.

HTTP_QUERY_MESSAGE_ID

12

Ya no se admite.

HTTP_QUERY_MIME_VERSION

0

Recibe la versión del protocolo MIME que se usó para construir el mensaje.

HTTP_QUERY_ORIG_URI

34

Obsoleto. Solo se mantiene para la compatibilidad de aplicaciones heredadas.

HTTP_QUERY_PRAGMA

17

Recibe las directivas específicas de la implementación que pueden aplicarse a cualquier destinatario a lo largo de la cadena de solicitudes y respuestas.

HTTP_QUERY_PROXY_AUTHENTICATE

41

Recupera el esquema de autenticación y el dominio kerberos devueltos por el proxy.

HTTP_QUERY_PROXY_AUTHORIZATION

61

Recupera el encabezado que se usa para identificar al usuario en un proxy que requiere autenticación. Este encabezado solo se puede recuperar antes de enviar la solicitud al servidor.

HTTP_QUERY_PROXY_CONNECTION

69

Recupera el encabezado Proxy-Connection.

HTTP_QUERY_PUBLIC

8

Recibe métodos disponibles en este servidor.

HTTP_QUERY_RANGE

62

Recupera el intervalo de bytes de una entidad.

HTTP_QUERY_RAW_HEADERS

21

Recibe todos los encabezados devueltos por el servidor. Cada encabezado finaliza por "\0". Una "\0" adicional finaliza la lista de encabezados.

HTTP_QUERY_RAW_HEADERS_CRLF

22

Recibe todos los encabezados devueltos por el servidor. Cada encabezado está separado por una secuencia de retorno/avance de línea de carro (CR/LF).

HTTP_QUERY_REFERER

35

Recibe el identificador uniforme de recursos (URI) del recurso donde se obtuvo el URI solicitado.

HTTP_QUERY_REFRESH

46

Obsoleto. Solo se mantiene para la compatibilidad de aplicaciones heredadas.

HTTP_QUERY_REQUEST_METHOD

45

Recibe el verbo HTTP que se usa en la solicitud, normalmente GET o POST.

HTTP_QUERY_RETRY_AFTER

36

Recupera la cantidad de tiempo que se espera que el servicio no esté disponible.

HTTP_QUERY_SERVER

37

Recupera datos sobre el software usado por el servidor de origen para controlar la solicitud.

HTTP_QUERY_SET_COOKIE

43

Recibe el valor de la cookie establecida para la solicitud.

HTTP_QUERY_STATUS_CODE

19

Recibe el código de estado devuelto por el servidor. Para obtener más información y una lista de valores posibles, vea Códigos de estado HTTP.

HTTP_QUERY_STATUS_TEXT

20

Recibe cualquier texto adicional devuelto por el servidor en la línea de respuesta.

HTTP_QUERY_TITLE

38

Obsoleto. Solo se mantiene para la compatibilidad de aplicaciones heredadas.

HTTP_QUERY_TRANSFER_ENCODING

63

Recupera el tipo de transformación que se ha aplicado al cuerpo del mensaje para que se pueda transferir de forma segura entre el remitente y el destinatario.

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70

Recupera el encabezado Unless-Modified-Since.

HTTP_QUERY_UPGRADE

64

Recupera los protocolos de comunicación adicionales admitidos por el servidor.

HTTP_QUERY_URI

13

Recibe algunos o todos los identificadores uniformes de recursos (URI) por los que se puede identificar el recurso Request-URI.

HTTP_QUERY_USER_AGENT

39

Recupera datos sobre el agente de usuario que realizó la solicitud.

HTTP_QUERY_VARY

65

Recupera el encabezado que indica que la entidad se seleccionó de una serie de representaciones disponibles de la respuesta mediante la negociación controlada por el servidor.

HTTP_QUERY_VERSION

18

Recibe el último código de respuesta devuelto por el servidor.

HTTP_QUERY_VIA

66

Recupera los protocolos y destinatarios intermedios entre el agente de usuario y el servidor en las solicitudes, y entre el servidor de origen y el cliente en las respuestas.

HTTP_QUERY_WARNING

67

Recupera datos adicionales sobre el estado de una respuesta que es posible que el código de estado de respuesta no refleje.

HTTP_QUERY_WWW_AUTHENTICATE

40

Recupera el esquema de autenticación y el dominio kerberos devueltos por el servidor.

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79

Recupera el valor del encabezado X-Content-Type-Options.

HTTP_QUERY_P3P

80

Recupera el valor del encabezado P3P.

HTTP_QUERY_X_P2P_PEERDIST

81

Recupera el valor del encabezado X-P2P-PeerDist.

HTTP_QUERY_TRANSLATE

82

Recupera el valor del encabezado translate.

HTTP_QUERY_X_UA_COMPATIBLE

83

Recupera el valor del encabezado X-UA-Compatible.

HTTP_QUERY_DEFAULT_STYLE

84

Recupera el valor del encabezado Default-Style.

HTTP_QUERY_X_FRAME_OPTIONS

85

Recupera el valor del encabezado X-Frame-Options.

HTTP_QUERY_X_XSS_PROTECTION

86

Recupera el valor del encabezado X-XSS-Protection.

Las marcas modificadores se usan junto con una marca de atributo para modificar la solicitud. Las marcas modificadores modifican el formato de los datos devueltos o indican dónde Debe buscar los datos HttpQueryInfo (o QueryInfo).

HTTP_QUERY_FLAG_COALESCE

0x10000000

Sin implementar.

HTTP_QUERY_FLAG_NUMBER

0x20000000

Devuelve los datos como un número de 32 bits para los encabezados cuyo valor es un número, como el código de estado.

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000

Consulta solo encabezados de solicitud.

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000

Devuelve el valor de encabezado como una estructura SYSTEMTIME , que no requiere que la aplicación analice los datos. Use para encabezados cuyo valor sea una cadena de fecha y hora, como "Hora de última modificación".

Comentarios

Nota

WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use los servicios HTTP de Microsoft Windows (WinHTTP).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Wininet.h