CHttpFile::QueryInfo

Articolo
03/05/2013

Chiamare la funzione membro per restituire la risposta o intestazioni di richiesta da una richiesta HTTP.

BOOL QueryInfo(
   DWORD dwInfoLevel,
   LPVOID lpvBuffer,
   LPDWORD lpdwBufferLength,
   LPDWORD lpdwIndex = NULL 
) const;
BOOL QueryInfo(
   DWORD dwInfoLevel,
   CString& str,
   LPDWORD dwIndex = NULL 
) const;
BOOL QueryInfo(
   DWORD dwInfoLevel,
   SYSTEMTIME* pSysTime,
   LPDWORD dwIndex = NULL 
) const;

Parametri

dwInfoLevel
Una combinazione dell'attributo da eseguire una query e i seguenti flag che specificano il tipo di informazioni necessario:
- HTTP_QUERY_CUSTOM cerca il nome dell'intestazione e restituisce il valore in lpvBuffer di output.HTTP_QUERY_CUSTOM genera un'asserzione se l'intestazione non trovata.
- HTTP_QUERY_FLAG_REQUEST_HEADERS in genere, l'applicazione esegue una query sulle intestazioni di risposta, ma un'applicazione può inoltre intestazioni di richiesta di query utilizzando il flag.
- HTTP_QUERY_FLAG_SYSTEMTIME per le intestazioni del cui valore è una stringa data/ora/data, come "now dell'ultima modifica," completamento del flag il valore di intestazione come struttura standard Win32 SYSTEMTIME che non richiede l'applicazione analizzare i dati.Se si utilizza questo flag, è consigliabile utilizzare override SYSTEMTIME della funzione.
- HTTP_QUERY_FLAG_NUMBER per le intestazioni del cui valore è un numero, ad esempio il codice di stato, restituito da questo flag i dati come numero a 32 bit.
Vedere la sezione Note per un elenco di valori possibili.
lpvBuffer
Un puntatore a un buffer che riceve informazioni.
lpdwBufferLength
La voce, su questi punti a un valore contenente la lunghezza del buffer di dati, in numero di caratteri o di byte.Vedere la sezione Note per informazioni dettagliate su questo parametro.
lpdwIndex
Un puntatore a un indice in base zero di intestazione.Può essere NULL.Utilizzare questo flag per enumerare le intestazioni con lo stesso nome.In input, lpdwIndex indica l'indice dell'intestazione specificata da restituire.In output, lpdwIndex indica l'indice dell'.Se l'indice seguente non è disponibile, ERROR_HTTP_HEADER_NOT_FOUND viene restituito.
str
Un riferimento all'oggetto CString che riceve le informazioni restituite.
dwIndex
Un valore di indice.Vedere lpdwIndex.
pSysTime
Un puntatore a una struttura di Win32 SYSTEMTIME.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.Se la chiamata ha esito negativo, la funzione Win32 GetLastError può essere chiamata per determinare la causa dell'errore.

Note

Utilizzare questa funzione membro solo dopo una corrispondenza chiamata a SendRequest o su un oggetto CHttpFile creato correttamente da OpenURL.

È possibile recuperare i seguenti tipi di dati da QueryInfo:

stringhe (impostazione predefinita)
SYSTEMTIME ("per i dati: " Scade: " e così via, intestazioni)
DWORD ad STATUS_CODE, CONTENT_LENGTH, e così via).

Quando una stringa è scritta nel buffer e la funzione membro ha esito positivo, lpdwBufferLength contiene la lunghezza della stringa in caratteri meno 1 per il carattere di terminazione null.

i valori possibili dwInfoLevel includono: