Sinalizadores de informações de consulta (Wininet.h)

As listas a seguir contêm os atributos e modificadores usados por HttpQueryInfo e QueryInfo.

Os sinalizadores de atributo são usados por HttpQueryInfo (ou QueryInfo) para indicar quais dados recuperar. A maioria dos sinalizadores de atributo é mapeada diretamente para um cabeçalho HTTP específico. Também há alguns sinalizadores especiais, como HTTP_QUERY_RAW_HEADERS, que não estão relacionados a um cabeçalho específico.

HTTP_QUERY_ACCEPT

24

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

HTTP_QUERY_ACCEPT_CHARSET

25

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

HTTP_QUERY_ACCEPT_ENCODING

26

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

HTTP_QUERY_ACCEPT_LANGUAGE

27

Recupera os idiomas naturais aceitáveis para a resposta.

HTTP_QUERY_ACCEPT_RANGES

42

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

HTTP_QUERY_AGE

48

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

HTTP_QUERY_ALLOW

7

Recebe os verbos HTTP compatíveis com o servidor.

HTTP_QUERY_AUTHORIZATION

28

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

HTTP_QUERY_CACHE_CONTROL

49

Recupera as diretivas de controle de cache.

HTTP_QUERY_CONNECTION

23

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

HTTP_QUERY_CONTENT_BASE

50

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

HTTP_QUERY_CONTENT_DESCRIPTION

4

Obsoleto. Mantido apenas para compatibilidade de aplicativos herdados.

HTTP_QUERY_CONTENT_DISPOSITION

47

Obsoleto. Mantido apenas para compatibilidade de aplicativos herdados.

HTTP_QUERY_CONTENT_ENCODING

29

Recupera quaisquer codificações de conteúdo adicionais que foram aplicadas a todo o recurso.

HTTP_QUERY_CONTENT_ID

3

Recupera a identificação de conteúdo.

HTTP_QUERY_CONTENT_LANGUAGE

6

Recupera o idioma em que o conteúdo está.

HTTP_QUERY_CONTENT_LENGTH

5

Recupera o tamanho do recurso, em bytes.

HTTP_QUERY_CONTENT_LOCATION

51

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

HTTP_QUERY_CONTENT_MD5

52

Recupera um resumo MD5 do corpo da entidade com a finalidade de fornecer um MIC (marcar de integridade de mensagem de ponta a ponta) para o corpo da entidade. Para obter mais informações, consulte RFC1864, o campo de cabeçalho Content-MD5, em https://ftp.isi.edu/in-notes/rfc1864.txt.

HTTP_QUERY_CONTENT_RANGE

53

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

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2

Recebe a codificação de conteúdo adicional que foi aplicada ao recurso.

HTTP_QUERY_CONTENT_TYPE

1

Recebe o tipo de conteúdo do recurso (como texto/html).

HTTP_QUERY_COOKIE

44

Recupera todos os cookies associados à solicitação.

HTTP_QUERY_COST

15

Não tem mais suporte.

HTTP_QUERY_CUSTOM

65535

Faz com que HttpQueryInfo pesquise o nome do cabeçalho especificado em lpvBuffer e armazene os dados de cabeçalho em lpvBuffer.

HTTP_QUERY_DATE

9

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

HTTP_QUERY_DERIVED_FROM

14

Não tem mais suporte.

HTTP_QUERY_ECHO_HEADERS

73

Não implementado atualmente.

HTTP_QUERY_ECHO_HEADERS_CRLF

74

Não implementado atualmente.

HTTP_QUERY_ECHO_REPLY

72

Não implementado atualmente.

HTTP_QUERY_ECHO_REQUEST

71

Não implementado atualmente.

HTTP_QUERY_ETAG

54

Recupera a marca de entidade para a entidade associada.

HTTP_QUERY_EXPECT

68

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

HTTP_QUERY_EXPIRES

10

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

HTTP_QUERY_FORWARDED

30

Obsoleto. Mantido apenas para compatibilidade de aplicativos herdados.

HTTP_QUERY_FROM

31

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

HTTP_QUERY_HOST

55

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

HTTP_QUERY_IF_MATCH

56

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

HTTP_QUERY_IF_MODIFIED_SINCE

32

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

HTTP_QUERY_IF_NONE_MATCH

57

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

HTTP_QUERY_IF_RANGE

58

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.

HTTP_QUERY_IF_UNMODIFIED_SINCE

59

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

HTTP_QUERY_LAST_MODIFIED

11

Recebe a data e a hora em que o servidor acredita que o recurso foi modificado pela última vez.

HTTP_QUERY_LINK

16

Obsoleto. Mantido apenas para compatibilidade de aplicativos herdados.

HTTP_QUERY_LOCATION

33

Recupera o URI (Uniform Resource Identifier) absoluto usado em um cabeçalho de resposta local.

HTTP_QUERY_MAX

78

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

HTTP_QUERY_MAX_FORWARDS

60

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

HTTP_QUERY_MESSAGE_ID

12

Não tem mais suporte.

HTTP_QUERY_MIME_VERSION

0

Recebe a versão do protocolo MIME que foi usada para construir a mensagem.

HTTP_QUERY_ORIG_URI

34

Obsoleto. Mantido apenas para compatibilidade de aplicativos herdados.

HTTP_QUERY_PRAGMA

17

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

HTTP_QUERY_PROXY_AUTHENTICATE

41

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

HTTP_QUERY_PROXY_AUTHORIZATION

61

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.

HTTP_QUERY_PROXY_CONNECTION

69

Recupera o cabeçalho Proxy-Connection.

HTTP_QUERY_PUBLIC

8

Recebe métodos disponíveis neste servidor.

HTTP_QUERY_RANGE

62

Recupera o intervalo de bytes de uma entidade.

HTTP_QUERY_RAW_HEADERS

21

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

HTTP_QUERY_RAW_HEADERS_CRLF

22

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

HTTP_QUERY_REFERER

35

Recebe o URI (Uniform Resource Identifier) do recurso em que o URI solicitado foi obtido.

HTTP_QUERY_REFRESH

46

Obsoleto. Mantido apenas para compatibilidade de aplicativos herdados.

HTTP_QUERY_REQUEST_METHOD

45

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

HTTP_QUERY_RETRY_AFTER

36

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

HTTP_QUERY_SERVER

37

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

HTTP_QUERY_SET_COOKIE

43

Recebe o valor do conjunto de cookies para a solicitação.

HTTP_QUERY_STATUS_CODE

19

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

HTTP_QUERY_STATUS_TEXT

20

Recebe qualquer texto adicional retornado pelo servidor na linha de resposta.

HTTP_QUERY_TITLE

38

Obsoleto. Mantido apenas para compatibilidade de aplicativos herdados.

HTTP_QUERY_TRANSFER_ENCODING

63

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.

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70

Recupera o cabeçalho Unless-Modified-Since.

HTTP_QUERY_UPGRADE

64

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

HTTP_QUERY_URI

13

Recebe alguns ou todos os URIs (Uniform Resource Identifiers) pelos quais o recurso Request-URI pode ser identificado.

HTTP_QUERY_USER_AGENT

39

Recupera dados sobre o agente de usuário que fez a solicitação.

HTTP_QUERY_VARY

65

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.

HTTP_QUERY_VERSION

18

Recebe o último código de resposta retornado pelo servidor.

HTTP_QUERY_VIA

66

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.

HTTP_QUERY_WARNING

67

Recupera dados adicionais sobre o status de uma resposta que podem não ser refletidos pela resposta status código.

HTTP_QUERY_WWW_AUTHENTICATE

40

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

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79

Recupera o valor do cabeçalho X-Content-Type-Options.

HTTP_QUERY_P3P

80

Recupera o valor do cabeçalho P3P.

HTTP_QUERY_X_P2P_PEERDIST

81

Recupera o valor do cabeçalho X-P2P-PeerDist.

HTTP_QUERY_TRANSLATE

82

Recupera o valor do cabeçalho de tradução.

HTTP_QUERY_X_UA_COMPATIBLE

83

Recupera o valor do cabeçalho compatível com X-UA.

HTTP_QUERY_DEFAULT_STYLE

84

Recupera o valor do cabeçalho Default-Style.

HTTP_QUERY_X_FRAME_OPTIONS

85

Recupera o valor do cabeçalho X-Frame-Options.

HTTP_QUERY_X_XSS_PROTECTION

86

Recupera o valor do cabeçalho X-XSS-Protection.

Os sinalizadores modificador são usados em conjunto com um sinalizador de atributo para modificar a solicitação. Os sinalizadores do modificador modificam o formato dos dados retornados ou indicam onde HttpQueryInfo (ou QueryInfo) deve pesquisar os dados.

HTTP_QUERY_FLAG_COALESCE

0x10000000

Não implementado.

HTTP_QUERY_FLAG_NUMBER

0x20000000

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

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000

Consulta apenas cabeçalhos de solicitação.

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000

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

Comentários

Observação

O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).

Requisitos

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