CHttpFile::QueryInfo

BOOL QueryInfo (DWORD dwInfoLevel, elementem LPVOID lpvBuffer, LPDWORD lpdwBufferLength, LPDWORD lpdwIndex = NULL) stała;

BOOL QueryInfo (DWORD dwInfoLevelCString&strLPDWORDdwIndex= NULL) stała;

BOOL QueryInfo (DWORD dwInfoLevel, SYSTEMTIME * pSysTime, LPDWORD dwIndex = NULL) stała;

Wartość zwracany

Niezerowa, jeśli kończy się pomyślnie; przeciwnym razie 0. Jeśli wezwanie się nie powiedzie, funkcji Win32 GetLastError może być wywołana aby ustalić przyczynę błędu.

Parametry

dwInfoLevel

Kombinacja atrybutu do kwerendy i następujące flagi, które określają rodzaj żądanych informacji:

• HTTP_QUERY_CUSTOM   Wyszukuje nazwę nagłówka i zwraca tę wartość w lpvBuffer na wyjściu. HTTP_QUERY_CUSTOM generuje potwierdzenia, jeśli nagłówek nie zostanie odnaleziony.
  
  
• HTTP_QUERY_FLAG_REQUEST_HEADERS   Zazwyczaj stosowania kwerend nagłówki odpowiedzi, ale aplikacja może również kwerendy nagłówki żądania przy użyciu tej flagi.
  
  
• HTTP_QUERY_FLAG_SYSTEMTIME   Dla tych nagłówków, którego wartością jest ciąg data/godzina, takich jak "Last-Zmodyfikowana-Time," Ta flaga zwraca wartość nagłówka jako standardowy Win32 strukturę SYSTEMTIME , który wymaga zastosowania do analizowania danych. Jeśli używasz tej flagi, warto użyć zastępowanie SYSTEMTIME funkcji.
  
  
• HTTP_QUERY_FLAG_&NUMBERnbsp;  Dla tych nagłówków, którego wartość jest liczbą, takie jak kod stanu ta flaga zwraca dane jako 32-bitową liczbą.

  Zobacz sekcję spostrzeżenia do listy możliwych wartości.

lpvBuffer

Wskaźnik do buforu, który odbiera informacje.

lpdwBufferLength

W zapisie wskazuje to na wartość zawierających długość buforu danych, w polu Liczba znaków lub liczbę bajtów. Zobacz sekcję spostrzeżenia bardziej szczegółowe informacje dotyczące tego parametru.

lpdwIndex

Wskaźnik indeksu nagłówek od zera. Może być zerowa. Użyj tej flagi, aby wyliczyć wielokrotne nagłówki o tej samej nazwie. Na wejściu lpdwIndex wskazuje indeks określonego nagłówka do zwrotu. Produkcja lpdwIndex wskazuje indeks następnego nagłówka. Jeśli nie można odnaleźć następny indeksu, zwracany jest ERROR_HTTP_HEADER_NOT_FOUND.

str

Odwołanie do obiektu CString otrzymująca informacje zwrócone.

dwIndex

Wartość indeksu. Zobacz lpdwIndex.

pSysTime

Wskaźnik Win32 strukturę SYSTEMTIME.

Uwagi

Wywołanie tej funkcji członek powrotu odpowiedzi lub żądanie nagłówków z żądania HTTP. Ta funkcja Państwa tylko po wywołaniu pomyślne Wysłanie żądanie lub na obiekcie CHttpFile pomyślnie utworzone przez OpenURL.

Następujące typy danych można pobrać z QueryInfo:

• ciągi (domyślnie)
  
  
• SYSTEMTIME (dla "danych: „" Data wygaśnięcia: "itp, nagłówki)
  
  
• DWORD ( STATUS_CODE, CONTENT_LENGTH, itp.)

Jeśli ciąg jest zapisywany do buforu, a funkcja Członkowskie powiedzie się, lpdwBufferLength zawiera długość ciągu w znaków minus 1 zakończeń znaku NULL.

Wartości możliwe dwInfoLevel:

• 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

Omówie&nie CHttpFile |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CInternetFile, CHttpConnection::OpenRequest, CFtpConnection, CGopherConnection, CInternetConnection