Funzione HttpQueryInfoA (wininet.h)
Recupera le informazioni di intestazione associate a una richiesta HTTP.
Sintassi
BOOL HttpQueryInfoA(
[in] HINTERNET hRequest,
[in] DWORD dwInfoLevel,
[in, out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwBufferLength,
[in, out] LPDWORD lpdwIndex
);
Parametri
[in] hRequest
Handle restituito da una chiamata alla funzione HttpOpenRequest o InternetOpenUrl.
[in] dwInfoLevel
Combinazione di un attributo da recuperare e flag che modificano la richiesta. Per un elenco dei possibili valori di attributo e modificatore, vedere Flag informazioni query.
[in, out] lpBuffer
Puntatore a un buffer per ricevere le informazioni richieste. Questo parametro non deve essere NULL.
[in, out] lpdwBufferLength
Puntatore a una variabile che contiene, in ingresso, le dimensioni in byte del buffer a cui punta lpvBuffer.
Quando la funzione viene restituita correttamente, questa variabile contiene il numero di byte di informazioni scritte nel buffer. Nel caso di una stringa, il conteggio dei byte non include la terminazione della stringa carattere null.
Quando la funzione
ha esito negativo con un codice di errore esteso di ERROR_INSUFFICIENT_BUFFER, la variabile a cui punta lpdwBufferLength contiene in uscita le dimensioni, in byte, di un buffer sufficientemente grande da ricevere le informazioni richieste. L'applicazione chiamante può quindi allocare un buffer di questa dimensione o superiore e chiamare di nuovo la funzione.
[in, out] lpdwIndex
Puntatore a un indice di intestazione in base zero usato per enumerare più intestazioni con lo stesso nome. Quando si chiama la funzione, questo parametro è l'indice dell'intestazione specificata da restituire. Quando la funzione viene restituita, questo parametro è l'indice dell'intestazione successiva. Se non è possibile trovare l'indice successivo, viene restituito ERROR_HTTP_HEADER_NOT_FOUND.
Valore restituito
Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
È possibile recuperare i tipi di dati seguenti da HttpQueryInfo:
- Stringhe (impostazione predefinita)
- SYSTEMTIME (per le date)
- DWORD (per STATUS_CODE, CONTENT_LENGTHe così via, se HTTP_QUERY_FLAG_NUMBER è stato usato)
Se l'applicazione richiede che i dati vengano restituiti come tipo di dati diversi da una stringa, è necessario includere il modificatore appropriato con l'attributo passato a dwInfoLevel.
La funzione httpQueryInfo
Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro dall'interno di DllMain o dai costruttori e distruttori di oggetti globali.
Nota
L'intestazione wininet.h definisce HttpQueryInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 2000 Professional [solo app desktop] |
| server minimo supportato | Windows 2000 Server [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
wininet.h |
| libreria |
Wininet.lib |
| dll | Wininet.dll |