QueryInfo

BOOL QueryInfo (DWORD dwInfoLevel, LPVOID lpvBuffer, LPDWORD lpdwBufferLength, LPDWORD lpdwIndex = NULL) const;

BOOL QueryInfo (DWORD dwInfoLevelCString&StrLPDWORDdwIndex= NULL) const;

BOOL QueryInfo (DWORD dwInfoLevel, SYSTEMTIME * pSysTime, LPDWORD dwIndex = NULL) const;

Valore restituito

Diverso da zero in caso di successo; 0 altrimenti. Se la chiamata ha esito negativo, la funzione Win32 può essere chiamato GetLastError per determinare la causa dell'errore.

Parametri

dwInfoLevel

Una combinazione dell'attributo per query e i seguenti flag che specificano il tipo di informazioni richieste:

• HTTP_QUERY_CUSTOM   Trova il nome di intestazione e restituisce questo valore in lpvBuffer in uscita. HTTP_QUERY_CUSTOM genera un'asserzione se l'intestazione non è trovato.
  
  
• HTTP_QUERY_FLAG_REQUEST_HEADERS   In genere, l'applicazione esegue una query intestazioni di risposta, ma un'applicazione può anche eseguire query di intestazioni di richiesta utilizzando questo flag.
  
  
• HTTP_QUERY_FLAG_SYSTEMTIME   Per tali intestazioni il cui valore è una stringa di data e ora, ad esempio "Last-Modified-Time," questo flag restituisce il valore dell'intestazione come un Win32 standard struttura SYSTEMTIME che non richiede l'applicazione per analizzare i dati. Se si utilizza questo flag, si consiglia di utilizzare l'override della funzione di SYSTEMTIME.
  
  
• HTTP_QUERY_FLAG_&NUMBERnbsp;  Per le intestazioni di cui valore è un numero, ad esempio il codice di stato, questo flag restituisce i dati come un numero a 32 bit.

  Vedere la sezione osservazioni per un elenco dei valori possibili.

lpvBuffer

Puntatore a un buffer che riceve le informazioni.

lpdwBufferLength

All'entrata, si punta a un valore contenente la lunghezza del buffer dei dati, in numero di caratteri o byte. Vedere la sezione osservazioni per informazioni più dettagliate su questo parametro.

lpdwIndex

Puntatore a un indice in base zero dell'intestazione. Può essere NULL. Utilizzare questo flag per enumerare le intestazioni multiple con lo stesso nome. In input, lpdwIndex indica l'indice dell'intestazione specificato da restituire. Produzione, lpdwIndex indica l'indice dell'intestazione successiva. Se non è possibile trovare l'indice successivo, viene restituito ERROR_HTTP_HEADER_NOT_FOUND.

str

Un riferimento all'oggetto CString ricevendo le informazioni restituite.

dwIndex

Un valore di indice. Vedi lpdwIndex.

pSysTime

Puntatore a un Win32 struttura SYSTEMTIME.

Osservazioni

Chiamare questa funzione membro per restituire la risposta o richiedere intestazioni da una richiesta HTTP. Utilizzare questa funzione membro solo dopo una chiamata riuscita a SendRequest o su un oggetto CHttpFile realizzata con successo da OpenURL.

È possibile recuperare i seguenti tipi di dati da QueryInfo:

• stringhe (impostazione predefinita)
  
  
• SYSTEMTIME (per "dati:" "Expires:" intestazioni ecc,)
  
  
• DWORD (per STATUS_CODE, CONTENT_LENGTH, ecc.)

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

I valori possibili dwInfoLevel includono:

• HTTP_QUERY_MIME_VERSION
  
  
• HTTP_QUERY_CONTENT_TYPE
  
  
• HTTP_QUERY_CONTENT_TRANSFER_ENCODING
  
  
• HTTP_QUERY_CONTENT_ID
  
  
• HTTP_QUERY_CONTENT_DESCRIPTION
  
  
• HTTP_QUERY_CONTENT_LENGTH
  
  
• HTTP_QUERY_ALLOWED_METHODS
  
  
• HTTP_QUERY_PUBLIC_METHODS
  
  
• HTTP_QUERY_DATE
  
  
• HTTP_QUERY_EXPIRES
  
  
• HTTP_QUERY_LAST_MODIFIED
  
  
• HTTP_QUERY_MESSAGE_ID
  
  
• HTTP_QUERY_URI
  
  
• HTTP_QUERY_DERIVED_FROM
  
  
• HTTP_QUERY_LANGUAGE
  
  
• HTTP_QUERY_COST
  
  
• HTTP_QUERY_WWW_LINK
  
  
• HTTP_QUERY_PRAGMA
  
  
• HTTP_QUERY_VERSION
  
  
• HTTP_QUERY_STATUS_CODE
  
  
• HTTP_QUERY_STATUS_TEXT
  
  
• HTTP_QUERY_RAW_HEADERS
  
  
• HTTP_QUERY_RAW_HEADERS_CRLF

CHttpFile pa&noramica |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CInternetFile, CHttpConnection:: OpenRequest, CFtpConnection, CGopherConnection consente, CInternetConnection consente