Flag di informazioni di query (Wininet.h)

Gli elenchi seguenti contengono gli attributi e i modificatori usati da HttpQueryInfo e QueryInfo.

I flag di attributo vengono usati da HttpQueryInfo (o QueryInfo) per indicare i dati da recuperare. La maggior parte dei flag di attributo viene mappata direttamente a un'intestazione HTTP specifica. Esistono anche alcuni flag speciali, ad esempio HTTP_QUERY_RAW_HEADERS, che non sono correlati a un'intestazione specifica.

HTTP_QUERY_ACCEPT

24

Recupera i tipi di supporti accettabili per la risposta.

HTTP_QUERY_ACCEPT_CHARSET

25

Recupera i set di caratteri accettabili per la risposta.

HTTP_QUERY_ACCEPT_ENCODING

26

Recupera i valori di codifica del contenuto accettabili per la risposta.

HTTP_QUERY_ACCEPT_LANGUAGE

27

Recupera le lingue naturali accettabili per la risposta.

HTTP_QUERY_ACCEPT_RANGES

42

Recupera i tipi di richieste di intervallo accettate per una risorsa.

HTTP_QUERY_AGE

48

Recupera il campo Age response-header, che contiene la stima del mittente della quantità di tempo da quando la risposta è stata generata nel server di origine.

HTTP_QUERY_ALLOW

7

Riceve i verbi HTTP supportati dal server.

HTTP_QUERY_AUTHORIZATION

28

Recupera le credenziali di autorizzazione usate per una richiesta.

HTTP_QUERY_CACHE_CONTROL

49

Recupera le direttive del controllo cache.

HTTP_QUERY_CONNECTION

23

Recupera tutte le opzioni specificate per una connessione specifica e non deve essere comunicata dai proxy su ulteriori connessioni.

HTTP_QUERY_CONTENT_BASE

50

Recupera l'URI di base (Uniform Resource Identifier) per la risoluzione degli URL relativi all'interno dell'entità.

HTTP_QUERY_CONTENT_DESCRIPTION

4

Obsoleta. Gestito solo per la compatibilità dell'applicazione legacy.

HTTP_QUERY_CONTENT_DISPOSITION

47

Obsoleta. Gestito solo per la compatibilità dell'applicazione legacy.

HTTP_QUERY_CONTENT_ENCODING

29

Recupera eventuali codici di contenuto aggiuntivi applicati all'intera risorsa.

HTTP_QUERY_CONTENT_ID

3

Recupera l'identificazione del contenuto.

HTTP_QUERY_CONTENT_LANGUAGE

6

Recupera la lingua in cui si trova il contenuto.

HTTP_QUERY_CONTENT_LENGTH

5

Recupera le dimensioni della risorsa, in byte.

HTTP_QUERY_CONTENT_LOCATION

51

Recupera il percorso della risorsa per l'entità racchiusa nel messaggio.

HTTP_QUERY_CONTENT_MD5

52

Recupera un digest MD5 del corpo dell'entità allo scopo di fornire un controllo di integrità dei messaggi end-to-end (MIC) per il corpo dell'entità. Per altre informazioni, vedere RFC1864, Il campo intestazione Content-MD5, all'indirizzo https://ftp.isi.edu/in-notes/rfc1864.txt.

HTTP_QUERY_CONTENT_RANGE

53

Recupera la posizione nel corpo completo dell'entità in cui deve essere inserito il corpo parziale dell'entità e la dimensione totale del corpo completo dell'entità.

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2

Riceve la codifica di contenuto aggiuntiva applicata alla risorsa.

HTTP_QUERY_CONTENT_TYPE

1

Riceve il tipo di contenuto della risorsa, ad esempio testo/html.

HTTP_QUERY_COOKIE

44

Recupera tutti i cookie associati alla richiesta.

HTTP_QUERY_COST

15

Non più supportata.

HTTP_QUERY_CUSTOM

65535

Fa in modo che HttpQueryInfo cerchi il nome dell'intestazione specificato in lpvBuffer e archivii i dati dell'intestazione in lpvBuffer.

HTTP_QUERY_DATE

9

Riceve la data e l'ora in cui è stato generato il messaggio.

HTTP_QUERY_DERIVED_FROM

14

Non più supportata.

HTTP_QUERY_ECHO_HEADERS

73

Non implementato attualmente.

HTTP_QUERY_ECHO_HEADERS_CRLF

74

Non implementato attualmente.

HTTP_QUERY_ECHO_REPLY

72

Non implementato attualmente.

HTTP_QUERY_ECHO_REQUEST

71

Non implementato attualmente.

HTTP_QUERY_ETAG

54

Recupera il tag di entità per l'entità associata.

HTTP_QUERY_EXPECT

68

Recupera l'intestazione Expect, che indica se l'applicazione client deve prevedere risposte di serie 100.

HTTP_QUERY_EXPIRES

10

Riceve la data e l'ora dopo la quale la risorsa deve essere considerata obsoleta.

HTTP_QUERY_FORWARDED

30

Obsoleta. Gestito solo per la compatibilità dell'applicazione legacy.

HTTP_QUERY_FROM

31

Recupera l'indirizzo di posta elettronica per l'utente umano che controlla l'agente utente richiesto se viene specificata l'intestazione From.

HTTP_QUERY_HOST

55

Recupera l'host Internet e il numero di porta della risorsa richiesta.

HTTP_QUERY_IF_MATCH

56

Recupera il contenuto del campo di If-Match request-header.

HTTP_QUERY_IF_MODIFIED_SINCE

32

Recupera il contenuto dell'intestazione If-Modified-Since.

HTTP_QUERY_IF_NONE_MATCH

57

Recupera il contenuto del campo richiesta-intestazione If-None-Match.

HTTP_QUERY_IF_RANGE

58

Recupera il contenuto del campo di If-Range request-header. Questa intestazione consente all'applicazione client di verificare che l'entità correlata a una copia parziale dell'entità nella cache dell'applicazione client non sia stata aggiornata. Se l'entità non è stata aggiornata, inviare le parti mancanti dell'applicazione client. Se l'entità è stata aggiornata, inviare l'intera entità aggiornata.

HTTP_QUERY_IF_UNMODIFIED_SINCE

59

Recupera il contenuto del campo If-Unmodified-Since request-header.

HTTP_QUERY_LAST_MODIFIED

11

Riceve la data e l'ora in cui il server ritiene che la risorsa sia stata modificata.

HTTP_QUERY_LINK

16

Obsoleta. Gestito solo per la compatibilità dell'applicazione legacy.

HTTP_QUERY_LOCATION

33

Recupera l'URI (Uniform Resource Identifier) assoluto usato in un'intestazione di risposta percorso.

HTTP_QUERY_MAX

78

Non un flag di query. Indica il valore massimo di un valore HTTP_QUERY_*.

HTTP_QUERY_MAX_FORWARDS

60

Recupera il numero di proxy o gateway che possono inoltrare la richiesta al server in ingresso successivo.

HTTP_QUERY_MESSAGE_ID

12

Non più supportata.

HTTP_QUERY_MIME_VERSION

0

Riceve la versione del protocollo MIME usata per costruire il messaggio.

HTTP_QUERY_ORIG_URI

34

Obsoleta. Gestito solo per la compatibilità dell'applicazione legacy.

HTTP_QUERY_PRAGMA

17

Riceve le direttive specifiche dell'implementazione che possono essere applicate a qualsiasi destinatario lungo la catena di richiesta/risposta.

HTTP_QUERY_PROXY_AUTHENTICATE

41

Recupera lo schema di autenticazione e l'area di autenticazione restituita dal proxy.

HTTP_QUERY_PROXY_AUTHORIZATION

61

Recupera l'intestazione usata per identificare l'utente in un proxy che richiede l'autenticazione. Questa intestazione può essere recuperata solo prima dell'invio della richiesta al server.

HTTP_QUERY_PROXY_CONNECTION

69

Recupera l'intestazione di Proxy-Connection.

HTTP_QUERY_PUBLIC

8

Riceve i metodi disponibili in questo server.

HTTP_QUERY_RANGE

62

Recupera l'intervallo di byte di un'entità.

HTTP_QUERY_RAW_HEADERS

21

Riceve tutte le intestazioni restituite dal server. Ogni intestazione viene terminata da "\0". Un elemento aggiuntivo "\0" termina l'elenco di intestazioni.

HTTP_QUERY_RAW_HEADERS_CRLF

22

Riceve tutte le intestazioni restituite dal server. Ogni intestazione è separata da una sequenza di ritorno/riga a capo (CR/LF).

HTTP_QUERY_REFERER

35

Riceve l'URI (Uniform Resource Identifier) della risorsa in cui è stato ottenuto l'URI richiesto.

HTTP_QUERY_REFRESH

46

Obsoleta. Gestito solo per la compatibilità delle applicazioni legacy.

HTTP_QUERY_REQUEST_METHOD

45

Riceve il verbo HTTP usato nella richiesta, in genere GET o POST.

HTTP_QUERY_RETRY_AFTER

36

Recupera la quantità di tempo prevista per cui il servizio non è disponibile.

HTTP_QUERY_SERVER

37

Recupera i dati sul software utilizzato dal server di origine per gestire la richiesta.

HTTP_QUERY_SET_COOKIE

43

Riceve il valore del set di cookie per la richiesta.

HTTP_QUERY_STATUS_CODE

19

Riceve il codice di stato restituito dal server. Per altre informazioni e un elenco dei valori possibili, vedere Codici di stato HTTP.

HTTP_QUERY_STATUS_TEXT

20

Riceve qualsiasi testo aggiuntivo restituito dal server nella riga di risposta.

HTTP_QUERY_TITLE

38

Obsoleta. Gestito solo per la compatibilità delle applicazioni legacy.

HTTP_QUERY_TRANSFER_ENCODING

63

Recupera il tipo di trasformazione applicato al corpo del messaggio in modo che possa essere trasferito in modo sicuro tra il mittente e il destinatario.

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70

Recupera l'intestazione Unless-Modified-Since.

HTTP_QUERY_UPGRADE

64

Recupera i protocolli di comunicazione aggiuntivi supportati dal server.

HTTP_QUERY_URI

13

Riceve alcuni o tutti gli URI (Uniform Resource Identifier) da cui è possibile identificare la risorsa Request-URI.

HTTP_QUERY_USER_AGENT

39

Recupera i dati sull'agente utente che ha effettuato la richiesta.

HTTP_QUERY_VARY

65

Recupera l'intestazione che indica che l'entità è stata selezionata da una serie di rappresentazioni disponibili della risposta usando la negoziazione basata su server.

HTTP_QUERY_VERSION

18

Riceve l'ultimo codice di risposta restituito dal server.

HTTP_QUERY_VIA

66

Recupera i protocolli intermedi e i destinatari tra l'agente utente e il server nelle richieste e tra il server di origine e il client nelle risposte.

HTTP_QUERY_WARNING

67

Recupera dati aggiuntivi sullo stato di una risposta che potrebbe non essere riflessa dal codice di stato della risposta.

HTTP_QUERY_WWW_AUTHENTICATE

40

Recupera lo schema di autenticazione e l'area di autenticazione restituiti dal server.

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79

Recupera il valore dell'intestazione X-Content-Type-Options.

HTTP_QUERY_P3P

80

Recupera il valore dell'intestazione P3P.

HTTP_QUERY_X_P2P_PEERDIST

81

Recupera il valore dell'intestazione X-P2P-PeerDist.

HTTP_QUERY_TRANSLATE

82

Recupera il valore dell'intestazione translate.

HTTP_QUERY_X_UA_COMPATIBLE

83

Recupera il valore di intestazione compatibile con X-UA.

HTTP_QUERY_DEFAULT_STYLE

84

Recupera il valore dell'intestazione Default-Style.

HTTP_QUERY_X_FRAME_OPTIONS

85

Recupera il valore dell'intestazione X-Frame-Options.

HTTP_QUERY_X_XSS_PROTECTION

86

Recupera il valore dell'intestazione X-XSS-Protection.

I flag di modificatore vengono usati insieme a un flag di attributo per modificare la richiesta. I flag di modificatore modificano il formato dei dati restituiti o indicano dove HttpQueryInfo (o QueryInfo) deve cercare i dati.

HTTP_QUERY_FLAG_COALESCE

0x10000000

Non implementato.

HTTP_QUERY_FLAG_NUMBER

0x20000000

Restituisce i dati come numero a 32 bit per le intestazioni il cui valore è un numero, ad esempio il codice di stato.

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000

Esegue query solo sulle intestazioni di richiesta.

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000

Restituisce il valore dell'intestazione come struttura SYSTEMTIME , che non richiede all'applicazione di analizzare i dati. Usare per le intestazioni il cui valore è una stringa di data/ora, ad esempio "Last-Modified-Time".

Commenti

Nota

WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Wininet.h