Compartir a través de

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

  • Artículo

WinHttpQueryHeaders usa estos atributos y modificadores.

WinHttpQueryHeaders usa las marcas de atributo para indicar qué información se va 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 WINHTTP_QUERY_RAW_HEADERS, que no están relacionadas con un encabezado específico.

WINHTTP_QUERY_ACCEPT

Recupera los tipos de medios aceptables para la respuesta.

WINHTTP_QUERY_ACCEPT_CHARSET

Recupera los juegos de caracteres aceptables para la respuesta.

WINHTTP_QUERY_ACCEPT_ENCODING

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

WINHTTP_QUERY_ACCEPT_LANGUAGE

Recupera los lenguajes naturales aceptables para la respuesta.

WINHTTP_QUERY_ACCEPT_RANGES

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

WINHTTP_QUERY_AGE

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

WINHTTP_QUERY_ALLOW

Recibe los verbos HTTP admitidos por el servidor.

WINHTTP_QUERY_AUTHENTICATION_INFO

Recupera el encabezado Authentication-Info.

WINHTTP_QUERY_AUTHORIZATION

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

WINHTTP_QUERY_CACHE_CONTROL

Recupera las directivas de control de caché.

WINHTTP_QUERY_CONNECTION

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

WINHTTP_QUERY_CONTENT_BASE

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

WINHTTP_QUERY_CONTENT_DESCRIPTION

Obsoleto. Se mantiene para la compatibilidad de aplicaciones heredadas.

WINHTTP_QUERY_CONTENT_DISPOSITION

Obsoleto. Se mantiene para la compatibilidad de aplicaciones heredadas.

WINHTTP_QUERY_CONTENT_ENCODING

Recupera la codificación de contenido adicional que se ha aplicado a todo el recurso.

WINHTTP_QUERY_CONTENT_ID

Recupera la identificación del contenido.

WINHTTP_QUERY_CONTENT_LANGUAGE

Recupera el idioma en el que se escribe el contenido.

WINHTTP_QUERY_CONTENT_LENGTH

Recupera el tamaño del recurso, en bytes.

WINHTTP_QUERY_CONTENT_LOCATION

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

WINHTTP_QUERY_CONTENT_MD5

Recupera una síntesis MD5 del cuerpo de la entidad para proporcionar una comprobación de integridad de mensaje de un extremo a otro para el cuerpo de la entidad. Para obtener más información, consulte RFC 1864.

WINHTTP_QUERY_CONTENT_RANGE

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

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

Recupera una transformación de codificación aplicable a un cuerpo de entidad. Es posible que ya se haya aplicado, es posible que tenga que aplicarse o que, opcionalmente, sea aplicable.

WINHTTP_QUERY_CONTENT_TYPE

Recibe el tipo de contenido del recurso, como texto o html.

WINHTTP_QUERY_COOKIE

Recupera las cookies asociadas a la solicitud.

WINHTTP_QUERY_COST

No compatible.

WINHTTP_QUERY_CUSTOM

Hace que WinHttpQueryHeaders busque el nombre de encabezado especificado en el parámetro pwszName y almacene la información de encabezado en lpBuffer. Una aplicación puede usar WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT para limitar el tiempo máximo que espera esta consulta a que se reciban todos los encabezados.

WINHTTP_QUERY_DATE

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

WINHTTP_QUERY_DERIVED_FROM

No compatible.

WINHTTP_QUERY_ETAG

Recupera la etiqueta de entidad de la entidad asociada.

WINHTTP_QUERY_EXPECT

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

WINHTTP_QUERY_EXPIRES

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

WINHTTP_QUERY_FORWARDED

Obsoleto. Se mantiene para la compatibilidad de aplicaciones heredadas.

WINHTTP_QUERY_FROM

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

WINHTTP_QUERY_HOST

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

WINHTTP_QUERY_IF_MATCH

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

WINHTTP_QUERY_IF_MODIFIED_SINCE

Recupera el contenido del encabezado If-Modified-Since.

WINHTTP_QUERY_IF_NONE_MATCH

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

WINHTTP_QUERY_IF_RANGE

Recupera el contenido del campo If-Range encabezado de solicitud. Este encabezado permite a la aplicación cliente comprobar si no se ha actualizado la entidad relacionada con una copia parcial de la entidad en la memoria caché de la aplicación cliente. 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.

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

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

WINHTTP_QUERY_LINK

Obsoleto. Se mantiene para la compatibilidad de aplicaciones heredadas.

WINHTTP_QUERY_LAST_MODIFIED

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

WINHTTP_QUERY_LOCATION

Recupera el URI absoluto usado en un encabezado de respuesta ubicación.

WINHTTP_QUERY_MAX

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

WINHTTP_QUERY_MAX_FORWARDS

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

WINHTTP_QUERY_MESSAGE_ID

No compatible.

WINHTTP_QUERY_MIME_VERSION

Recibe la versión del protocolo Multipurpose Internet Mail Extensions (MIME) que se usó para construir el mensaje.

WINHTTP_QUERY_ORIG_URI

Obsoleto. Se mantiene para la compatibilidad de aplicaciones heredadas.

WINHTTP_QUERY_PRAGMA

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

WINHTTP_QUERY_PROXY_AUTHENTICATE

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

WINHTTP_QUERY_PROXY_AUTHORIZATION

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.

WINHTTP_QUERY_PROXY_CONNECTION

Recupera el encabezado Proxy-Connection.

WINHTTP_QUERY_PROXY_SUPPORT

Recupera el encabezado Proxy-Support.

WINHTTP_QUERY_PUBLIC

Recibe verbos HTTP disponibles en este servidor.

WINHTTP_QUERY_RANGE

Recupera el intervalo de bytes de una entidad.

WINHTTP_QUERY_RAW_HEADERS

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

WINHTTP_QUERY_RAW_HEADERS_CRLF

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

WINHTTP_QUERY_REFERER

Recibe el URI del recurso donde se obtuvo el URI solicitado.

WINHTTP_QUERY_REFRESH

Obsoleto. Se mantiene para la compatibilidad de aplicaciones heredadas.

WINHTTP_QUERY_REQUEST_METHOD

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

WINHTTP_QUERY_RETRY_AFTER

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

WINHTTP_QUERY_SERVER

Recupera información sobre el software utilizado por el servidor de origen para controlar la solicitud.

WINHTTP_QUERY_SET_COOKIE

Recibe el valor de la cookie establecida para la solicitud.

WINHTTP_QUERY_STATUS_CODE

Recibe el código de estado devuelto por el servidor. Para obtener una lista de los valores posibles, consulte Códigos de estado HTTP.

WINHTTP_QUERY_STATUS_TEXT

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

WINHTTP_QUERY_TITLE

Obsoleto. Se mantiene para la compatibilidad de aplicaciones heredadas.

WINHTTP_QUERY_TRANSFER_ENCODING

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.

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

Recupera el encabezado Unless-Modified-Since.

WINHTTP_QUERY_UPGRADE

Recupera los protocolos de comunicación adicionales que admite el servidor.

WINHTTP_QUERY_URI

Recibe algunos o todos los URI por los que se puede identificar el recurso Request-URI.

WINHTTP_QUERY_USER_AGENT

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

WINHTTP_QUERY_VARY

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 servidor.

WINHTTP_QUERY_VERSION

Recupera la versión HTTP que está presente en la línea de estado.

WINHTTP_QUERY_VIA

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

WINHTTP_QUERY_WARNING

Recupera información adicional sobre el estado de una respuesta que podría no reflejar el código de estado de la respuesta.

WINHTTP_QUERY_WWW_AUTHENTICATE

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

Las marcas modificadores se usan junto con una marca de atributo para modificar la solicitud. Las marcas modificadoras modifican el formato de los datos devueltos o indican dónde debe buscar la información la función WinHttpQueryHeaders .

WINHTTP_QUERY_FLAG_NUMBER

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.

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

Solo consulta los encabezados de solicitud.

WINHTTP_QUERY_FLAG_SYSTEMTIME

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

WINHTTP_QUERY_FLAG_TRAILERS

Introducido en Windows 11, versión 21H2 (10.0; Compilación 22000). Consulta tráileres de respuesta. Antes de consultar los finalizadores de respuesta, debe llamar a WinHttpReadData hasta que devuelva 0 bytes leídos.

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Introducido en Windows 11, versión 21H2 (10.0; Compilación 22000). De forma predeterminada, WinHttpQueryHeaders realiza una conversión Unicode antes de devolver el encabezado que se ha consultado. Si se establece esta marca, WinHttp devuelve el encabezado al autor de la llamada sin realizar esta conversión.

Requisitos

Requisito Valor
Cliente mínimo compatible Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio]
Encabezado
Winhttp.h

Consulte también