Condividi tramite

Flag di informazioni query (Winhttp.h)

  • Articolo

Questi attributi e modificatori vengono usati da WinHttpQueryHeaders.

I flag di attributo vengono usati da WinHttpQueryHeaders per indicare quali informazioni recuperare. La maggior parte dei flag di attributo viene mappata direttamente a un'intestazione HTTP specifica. Esistono anche alcuni flag speciali, ad esempio WINHTTP_QUERY_RAW_HEADERS, che non sono correlati a un'intestazione specifica.

WINHTTP_QUERY_ACCEPT

Recupera i tipi di supporti accettabili per la risposta.

WINHTTP_QUERY_ACCEPT_CHARSET

Recupera i set di caratteri accettabili per la risposta.

WINHTTP_QUERY_ACCEPT_ENCODING

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

WINHTTP_QUERY_ACCEPT_LANGUAGE

Recupera le lingue naturali accettabili per la risposta.

WINHTTP_QUERY_ACCEPT_RANGES

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

WINHTTP_QUERY_AGE

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

WINHTTP_QUERY_ALLOW

Riceve i verbi HTTP supportati dal server.

WINHTTP_QUERY_AUTHENTICATION_INFO

Recupera l'intestazione di Authentication-Info.

WINHTTP_QUERY_AUTHORIZATION

Recupera le credenziali di autorizzazione usate per una richiesta.

WINHTTP_QUERY_CACHE_CONTROL

Recupera le direttive del controllo cache.

WINHTTP_QUERY_CONNECTION

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

WINHTTP_QUERY_CONTENT_BASE

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

WINHTTP_QUERY_CONTENT_DESCRIPTION

Obsoleta. Gestito per la compatibilità delle applicazioni legacy.

WINHTTP_QUERY_CONTENT_DISPOSITION

Obsoleta. Gestito per la compatibilità delle applicazioni legacy.

WINHTTP_QUERY_CONTENT_ENCODING

Recupera codice di contenuto aggiuntivo applicato all'intera risorsa.

WINHTTP_QUERY_CONTENT_ID

Recupera l'identificazione del contenuto.

WINHTTP_QUERY_CONTENT_LANGUAGE

Recupera la lingua in cui è scritto il contenuto.

WINHTTP_QUERY_CONTENT_LENGTH

Recupera le dimensioni della risorsa, in byte.

WINHTTP_QUERY_CONTENT_LOCATION

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

WINHTTP_QUERY_CONTENT_MD5

Recupera un digest MD5 del corpo dell'entità allo scopo di fornire un controllo di integrità dei messaggi end-to-end per il corpo dell'entità. Per altre informazioni, vedere RFC 1864.

WINHTTP_QUERY_CONTENT_RANGE

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

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

Recupera una trasformazione di codifica applicabile a un corpo dell'entità. Potrebbe essere già stato applicato, potrebbe essere necessario applicare o può essere facoltativamente applicabile.

WINHTTP_QUERY_CONTENT_TYPE

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

WINHTTP_QUERY_COOKIE

Recupera tutti i cookie associati alla richiesta.

WINHTTP_QUERY_COST

Non supportato.

WINHTTP_QUERY_CUSTOM

Consente a WinHttpQueryHeaders di cercare il nome dell'intestazione specificato nel parametro pwszName e archiviare le informazioni sull'intestazione in lpBuffer. Un'applicazione può usare WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT per limitare il tempo massimo di attesa di ricezione di tutte le intestazioni.

WINHTTP_QUERY_DATE

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

WINHTTP_QUERY_DERIVED_FROM

Non supportato.

WINHTTP_QUERY_ETAG

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

WINHTTP_QUERY_EXPECT

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

WINHTTP_QUERY_EXPIRES

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

WINHTTP_QUERY_FORWARDED

Obsoleta. Gestito per la compatibilità delle applicazioni legacy.

WINHTTP_QUERY_FROM

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

WINHTTP_QUERY_HOST

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

WINHTTP_QUERY_IF_MATCH

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

WINHTTP_QUERY_IF_MODIFIED_SINCE

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

WINHTTP_QUERY_IF_NONE_MATCH

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

WINHTTP_QUERY_IF_RANGE

Recupera il contenuto del campo di If-Range request-header. Questa intestazione consente all'applicazione client di verificare se l'entità correlata a una copia parziale dell'entità nella cache dell'applicazione client non è 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.

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

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

WINHTTP_QUERY_LINK

Obsoleta. Gestito per la compatibilità delle applicazioni legacy.

WINHTTP_QUERY_LAST_MODIFIED

Riceve la data e l'ora in cui la risorsa è stata modificata. La data e l'ora sono determinate dal server.

WINHTTP_QUERY_LOCATION

Recupera l'URI assoluto usato in un'intestazione di risposta location.

WINHTTP_QUERY_MAX

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

WINHTTP_QUERY_MAX_FORWARDS

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

WINHTTP_QUERY_MESSAGE_ID

Non supportato.

WINHTTP_QUERY_MIME_VERSION

Riceve la versione del protocollo MIME (Multipurpose Internet Mail Extensions) usato per costruire il messaggio.

WINHTTP_QUERY_ORIG_URI

Obsoleta. Gestito per la compatibilità delle applicazioni legacy.

WINHTTP_QUERY_PRAGMA

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

WINHTTP_QUERY_PROXY_AUTHENTICATE

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

WINHTTP_QUERY_PROXY_AUTHORIZATION

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.

WINHTTP_QUERY_PROXY_CONNECTION

Recupera l'intestazione di Proxy-Connection.

WINHTTP_QUERY_PROXY_SUPPORT

Recupera l'intestazione di Proxy-Support.

WINHTTP_QUERY_PUBLIC

Riceve i verbi HTTP disponibili in questo server.

WINHTTP_QUERY_RANGE

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

WINHTTP_QUERY_RAW_HEADERS

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

WINHTTP_QUERY_RAW_HEADERS_CRLF

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

WINHTTP_QUERY_REFERER

Riceve l'URI della risorsa in cui è stato ottenuto l'URI richiesto.

WINHTTP_QUERY_REFRESH

Obsoleta. Gestito per la compatibilità delle applicazioni legacy.

WINHTTP_QUERY_REQUEST_METHOD

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

WINHTTP_QUERY_RETRY_AFTER

Recupera il tempo previsto che il servizio non sia disponibile.

WINHTTP_QUERY_SERVER

Recupera informazioni sul software usato dal server di origine per gestire la richiesta.

WINHTTP_QUERY_SET_COOKIE

Riceve il valore del set di cookie per la richiesta.

WINHTTP_QUERY_STATUS_CODE

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

WINHTTP_QUERY_STATUS_TEXT

Riceve testo aggiuntivo restituito dal server nella riga di risposta.

WINHTTP_QUERY_TITLE

Obsoleta. Gestito per la compatibilità delle applicazioni legacy.

WINHTTP_QUERY_TRANSFER_ENCODING

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.

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

Recupera l'intestazione Unless-Modified-Since.

WINHTTP_QUERY_UPGRADE

Recupera i protocolli di comunicazione aggiuntivi supportati dal server.

WINHTTP_QUERY_URI

Riceve alcuni o tutti gli URI in base al quale è possibile identificare la risorsa Request-URI.

WINHTTP_QUERY_USER_AGENT

Recupera informazioni sull'agente utente che ha effettuato la richiesta.

WINHTTP_QUERY_VARY

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

WINHTTP_QUERY_VERSION

Recupera la versione HTTP presente nella riga di stato.

WINHTTP_QUERY_VIA

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

WINHTTP_QUERY_WARNING

Recupera informazioni aggiuntive sullo stato di una risposta che potrebbe non essere riflessa dal codice di stato della risposta.

WINHTTP_QUERY_WWW_AUTHENTICATE

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

I flag di modifica vengono usati insieme a un flag di attributo per modificare la richiesta. I flag del modificatore modificano il formato dei dati restituiti o indicano dove la funzione WinHttpQueryHeaders deve cercare le informazioni.

WINHTTP_QUERY_FLAG_NUMBER

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

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

Solo le intestazioni delle richieste di query.

WINHTTP_QUERY_FLAG_SYSTEMTIME

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

WINHTTP_QUERY_FLAG_TRAILERS

Introdotta in Windows 11 versione 21H2 (10.0; Build 22000). Trailer di risposta delle query. Prima di eseguire query sui trailer di risposta, è necessario chiamare WinHttpReadData fino a quando non restituisce 0 byte di lettura.

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Introdotta in Windows 11 versione 21H2 (10.0; Build 22000). Per impostazione predefinita, WinHttpQueryHeaders esegue una conversione Unicode prima di restituire l'intestazione che è stata eseguita una query. Se questo flag è impostato, WinHttp restituisce l'intestazione al chiamante senza eseguire questa conversione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Intestazione
Winhttp.h

Vedi anche