Compartilhar via

Sinalizadores de Informações de Consulta (Winhttp.h)

  • Artigo

Esses atributos e modificadores são usados por WinHttpQueryHeaders.

Os sinalizadores de atributo são usados por WinHttpQueryHeaders para indicar quais informações recuperar. A maioria dos sinalizadores de atributo é mapeada diretamente para um cabeçalho HTTP específico. Também há alguns sinalizadores especiais, como WINHTTP_QUERY_RAW_HEADERS, que não estão relacionados a um cabeçalho específico.

WINHTTP_QUERY_ACCEPT

Recupera os tipos de mídia aceitáveis para a resposta.

WINHTTP_QUERY_ACCEPT_CHARSET

Recupera os conjuntos de caracteres aceitáveis para a resposta.

WINHTTP_QUERY_ACCEPT_ENCODING

Recupera os valores aceitáveis de codificação de conteúdo para a resposta.

WINHTTP_QUERY_ACCEPT_LANGUAGE

Recupera os idiomas naturais aceitáveis para a resposta.

WINHTTP_QUERY_ACCEPT_RANGES

Recupera os tipos de solicitações de intervalo que são aceitas para um recurso.

WINHTTP_QUERY_AGE

Recupera o campo Cabeçalho de resposta idade, que contém a estimativa do remetente da quantidade de tempo desde que a resposta foi gerada no servidor de origem.

WINHTTP_QUERY_ALLOW

Recebe os verbos HTTP compatíveis com o servidor.

WINHTTP_QUERY_AUTHENTICATION_INFO

Recupera o cabeçalho Authentication-Info.

WINHTTP_QUERY_AUTHORIZATION

Recupera as credenciais de autorização usadas para uma solicitação.

WINHTTP_QUERY_CACHE_CONTROL

Recupera as diretivas de controle de cache.

WINHTTP_QUERY_CONNECTION

Recupera as opções especificadas para uma conexão específica e não deve ser comunicada por proxies em conexões adicionais.

WINHTTP_QUERY_CONTENT_BASE

Recupera o URI (Uniform Resource Identifier) base para resolver URLs relativas dentro da entidade.

WINHTTP_QUERY_CONTENT_DESCRIPTION

Obsoleto. Mantido para compatibilidade de aplicativos herdados.

WINHTTP_QUERY_CONTENT_DISPOSITION

Obsoleto. Mantido para compatibilidade de aplicativos herdados.

WINHTTP_QUERY_CONTENT_ENCODING

Recupera a codificação de conteúdo adicional que foi aplicada a todo o recurso.

WINHTTP_QUERY_CONTENT_ID

Recupera a identificação de conteúdo.

WINHTTP_QUERY_CONTENT_LANGUAGE

Recupera o idioma no qual o conteúdo está escrito.

WINHTTP_QUERY_CONTENT_LENGTH

Recupera o tamanho do recurso, em bytes.

WINHTTP_QUERY_CONTENT_LOCATION

Recupera o local do recurso para a entidade incluída na mensagem.

WINHTTP_QUERY_CONTENT_MD5

Recupera um resumo MD5 do corpo da entidade com a finalidade de fornecer uma verificação de integridade de mensagem de ponta a ponta para o corpo da entidade. Para obter mais informações, consulte RFC 1864.

WINHTTP_QUERY_CONTENT_RANGE

Recupera o local no corpo completo da entidade em que o corpo da entidade parcial deve ser inserido e o tamanho total do corpo completo da entidade.

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

Recupera uma transformação de codificação aplicável a um corpo de entidade. Ele pode já ter sido aplicado, pode precisar ser aplicado ou pode ser opcionalmente aplicável.

WINHTTP_QUERY_CONTENT_TYPE

Recebe o tipo de conteúdo do recurso, como texto ou html.

WINHTTP_QUERY_COOKIE

Recupera todos os cookies associados à solicitação.

WINHTTP_QUERY_COST

Não há suporte.

WINHTTP_QUERY_CUSTOM

Faz com que WinHttpQueryHeaders pesquise o nome do cabeçalho especificado no parâmetro pwszName e armazene as informações de cabeçalho em lpBuffer. Um aplicativo pode usar WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT para limitar o tempo máximo que essa consulta aguarda o recebimento de todos os cabeçalhos.

WINHTTP_QUERY_DATE

Recebe a data e a hora em que a mensagem foi originada.

WINHTTP_QUERY_DERIVED_FROM

Não há suporte.

WINHTTP_QUERY_ETAG

Recupera a marca de entidade para a entidade associada.

WINHTTP_QUERY_EXPECT

Recupera o cabeçalho Expect, que indica se o aplicativo cliente deve esperar respostas da série 100.

WINHTTP_QUERY_EXPIRES

Recebe a data e a hora após as quais o recurso deve ser considerado desatualizado.

WINHTTP_QUERY_FORWARDED

Obsoleto. Mantido para compatibilidade de aplicativos herdados.

WINHTTP_QUERY_FROM

Recupera o endereço de email do usuário que controla o agente de usuário solicitante se o cabeçalho De for dado.

WINHTTP_QUERY_HOST

Recupera o host da Internet e o número da porta do recurso que está sendo solicitado.

WINHTTP_QUERY_IF_MATCH

Recupera o conteúdo do campo If-Match cabeçalho de solicitação.

WINHTTP_QUERY_IF_MODIFIED_SINCE

Recupera o conteúdo do cabeçalho If-Modified-Since.

WINHTTP_QUERY_IF_NONE_MATCH

Recupera o conteúdo do campo if-none-match request-header.

WINHTTP_QUERY_IF_RANGE

Recupera o conteúdo do campo If-Range cabeçalho de solicitação. Esse cabeçalho permite que o aplicativo cliente verifique se a entidade relacionada a uma cópia parcial da entidade no cache do aplicativo cliente não foi atualizada. Se a entidade não tiver sido atualizada, envie as partes que o aplicativo cliente está ausente. Se a entidade tiver sido atualizada, envie toda a entidade atualizada.

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

Recupera o conteúdo do campo If-Unmodified-Since request-header.

WINHTTP_QUERY_LINK

Obsoleto. Mantido para compatibilidade de aplicativos herdados.

WINHTTP_QUERY_LAST_MODIFIED

Recebe a data e a hora em que o recurso foi modificado pela última vez. A data e a hora são determinadas pelo servidor.

WINHTTP_QUERY_LOCATION

Recupera o URI absoluto usado em um cabeçalho de resposta local.

WINHTTP_QUERY_MAX

Indica o valor máximo de um valor WINHTTP_QUERY_*. Não é um sinalizador de consulta.

WINHTTP_QUERY_MAX_FORWARDS

Recupera o número de proxies ou gateways que podem encaminhar a solicitação para o próximo servidor de entrada.

WINHTTP_QUERY_MESSAGE_ID

Não há suporte.

WINHTTP_QUERY_MIME_VERSION

Recebe a versão do protocolo MIME (Multipurpose Internet Mail Extensions) que foi usado para construir a mensagem.

WINHTTP_QUERY_ORIG_URI

Obsoleto. Mantido para compatibilidade de aplicativos herdados.

WINHTTP_QUERY_PRAGMA

Recebe as diretivas específicas da implementação que podem se aplicar a qualquer destinatário ao longo da cadeia de solicitação/resposta.

WINHTTP_QUERY_PROXY_AUTHENTICATE

Recupera o esquema de autenticação e o realm retornados pelo proxy.

WINHTTP_QUERY_PROXY_AUTHORIZATION

Recupera o cabeçalho usado para identificar o usuário para um proxy que requer autenticação. Esse cabeçalho só pode ser recuperado antes que a solicitação seja enviada ao servidor.

WINHTTP_QUERY_PROXY_CONNECTION

Recupera o cabeçalho Proxy-Connection.

WINHTTP_QUERY_PROXY_SUPPORT

Recupera o cabeçalho Proxy-Support.

WINHTTP_QUERY_PUBLIC

Recebe verbos HTTP disponíveis neste servidor.

WINHTTP_QUERY_RANGE

Recupera o intervalo de bytes de uma entidade.

WINHTTP_QUERY_RAW_HEADERS

Recebe todos os cabeçalhos retornados pelo servidor. Cada cabeçalho é encerrado por "\0". Um "\0" adicional encerra a lista de cabeçalhos.

WINHTTP_QUERY_RAW_HEADERS_CRLF

Recebe todos os cabeçalhos retornados pelo servidor. Cada cabeçalho é separado por uma sequência cr/LF (retorno de carro/alimentação de linha).

WINHTTP_QUERY_REFERER

Recebe o URI do recurso em que o URI solicitado foi obtido.

WINHTTP_QUERY_REFRESH

Obsoleto. Mantido para compatibilidade de aplicativos herdados.

WINHTTP_QUERY_REQUEST_METHOD

Recebe o verbo HTTP que está sendo usado na solicitação, normalmente GET ou POST.

WINHTTP_QUERY_RETRY_AFTER

Recupera a quantidade de tempo que o serviço deve ficar indisponível.

WINHTTP_QUERY_SERVER

Recupera informações sobre o software usado pelo servidor de origem para lidar com a solicitação.

WINHTTP_QUERY_SET_COOKIE

Recebe o valor do cookie definido para a solicitação.

WINHTTP_QUERY_STATUS_CODE

Recebe o código de status retornado pelo servidor. Para obter uma lista de valores possíveis, consulte Códigos de status HTTP.

WINHTTP_QUERY_STATUS_TEXT

Recebe texto adicional retornado pelo servidor na linha de resposta.

WINHTTP_QUERY_TITLE

Obsoleto. Mantido para compatibilidade de aplicativos herdados.

WINHTTP_QUERY_TRANSFER_ENCODING

Recupera o tipo de transformação que foi aplicado ao corpo da mensagem para que possa ser transferido com segurança entre o remetente e o destinatário.

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

Recupera o cabeçalho Unless-Modified-Since.

WINHTTP_QUERY_UPGRADE

Recupera os protocolos de comunicação adicionais compatíveis com o servidor.

WINHTTP_QUERY_URI

Recebe parte ou todo o URI pelo qual o recurso Request-URI pode ser identificado.

WINHTTP_QUERY_USER_AGENT

Recupera informações sobre o agente do usuário que fez a solicitação.

WINHTTP_QUERY_VARY

Recupera o cabeçalho que indica que a entidade foi selecionada de várias representações disponíveis da resposta usando a negociação controlada pelo servidor.

WINHTTP_QUERY_VERSION

Recupera a versão HTTP que está presente na linha de status.

WINHTTP_QUERY_VIA

Recupera os protocolos e destinatários intermediários entre o agente do usuário e o servidor em solicitações e entre o servidor de origem e o cliente em respostas.

WINHTTP_QUERY_WARNING

Recupera informações adicionais sobre o status de uma resposta que podem não ser refletidas pelo código de status de resposta.

WINHTTP_QUERY_WWW_AUTHENTICATE

Recupera o esquema de autenticação e o realm retornados pelo servidor.

Os sinalizadores modificador são usados em conjunto com um sinalizador de atributo para modificar a solicitação. Os sinalizadores modificadores modificam o formato dos dados retornados ou indicam onde a função WinHttpQueryHeaders deve pesquisar as informações.

WINHTTP_QUERY_FLAG_NUMBER

Retorna os dados como um número de 32 bits para cabeçalhos cujo valor é um número, como o código de status.

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

Somente cabeçalhos de solicitação de consultas.

WINHTTP_QUERY_FLAG_SYSTEMTIME

Retorna o valor do cabeçalho como uma estrutura SYSTEMTIME , que não exige que o aplicativo analise os dados. Use para cabeçalhos cujo valor é uma cadeia de caracteres de data/hora, como "Last-Modified-Time".

WINHTTP_QUERY_FLAG_TRAILERS

Introduzido no Windows 11, versão 21H2 (10.0; Build 22000). Trailers de resposta de consultas. Antes de consultar trailers de resposta, você deve chamar WinHttpReadData até que ele retorne 0 bytes lidos.

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Introduzido no Windows 11, versão 21H2 (10.0; Build 22000). Por padrão, WinHttpQueryHeaders executa uma conversão Unicode antes de retornar o cabeçalho que foi consultado. Se esse sinalizador estiver definido, WinHttp retornará o cabeçalho para o chamador sem executar essa conversão.

Requisitos

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

Confira também