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

Requisitos