CHttpFile::QueryInfo

Artykuł
06/10/2015

Wywołanie tej funkcji Członkowskich powrotu odpowiedzi lub żądanie nagłówków z żądania 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;

Parametry

dwInfoLevel
Kombinacja atrybutu kwerendy i następujące flagi, które określają rodzaj żądanych informacji:
- HTTP_QUERY_CUSTOM znajduje się nazwa nagłówka i zwraca wartość w lpvBuffer na wyjściu.HTTP_QUERY_CUSTOM generuje potwierdzenia, jeśli nie zostanie odnaleziony nagłówka.
- HTTP_QUERY_FLAG_REQUEST_HEADERS zazwyczaj nagłówki odpowiedzi kwerendy do aplikacji, ale aplikacji można również kwerendy nagłówków żądania przy użyciu tej flagi.
- HTTP_QUERY_FLAG_SYSTEMTIME dla tych nagłówków, którego wartością jest ciąg daty i godziny, "Ostatniej modyfikacji-czasu," Flaga ta zwraca wartość nagłówka jako standardowy Win32 SYSTEMTIME strukturę, która nie wymaga stosowania analizować dane.Jeśli używasz tej flagi, możesz użyć SYSTEMTIME zastąpić funkcji.
- HTTP_QUERY_FLAG_NUMBER dla tych nagłówków, którego wartość jest liczbą, na przykład kod stanu tej flagi zwraca dane jako liczba 32-bitowych.
Zobacz uwagi sekcji listę możliwych wartości.
lpvBuffer
Wskaźnik do buforu, który odbiera informacje.
lpdwBufferLength
Na wejściu wskazuje to na wartość zawierająca długość buforu danych w liczbie znaków lub bajtów.Zobacz uwagi sekcji, aby uzyskać szczegółowe informacje dotyczące tego parametru.
lpdwIndex
Wskaźnik do indeksu nagłówek od zera.Może być NULL.Użyj tej flagi wyliczyć wiele nagłówków o tej samej nazwie.Na wejściu lpdwIndex wskazuje indeks określonego nagłówka, aby powrócić.Produkcja lpdwIndex wskazuje indeks następnego nagłówka.Jeśli nie można odnaleźć następny indeks, ERROR_HTTP_HEADER_NOT_FOUND jest zwracany.
str
Odwołanie do CString obiektu otrzymująca informacje zwrócone.
dwIndex
Wartość indeksu.See lpdwIndex.
pSysTime
Wskaźnik Win32 SYSTEMTIME struktury.

Wartość zwracana

Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.Jeżeli połączenie nie powiedzie się, funkcja Win32 GetLastError mogą być nazywane, aby ustalić przyczynę błędu.

Uwagi

Aby użyć tej funkcji Członkowskich tylko po pomyślne wywołanie Wysłanie żądanie zakończyło lub CHttpFile pomyślnie utworzone przez obiekt OpenURL.

Można pobierać dane z następujących typów QueryInfo:

ciągi (domyślnie)
SYSTEMTIME(dla "danych:" "wygasa:" etc, nagłówki)
DWORD(dla STATUS_CODE, CONTENT_LENGTHetc.)

Ciąg jest zapisywana w buforze, a funkcja Członkowskie powiedzie się, lpdwBufferLength zawiera długość ciągu w znaków minus 1 kończące NULL znaków.

Możliwe dwInfoLevel wartości obejmują: