CHttpFile::QueryInfo

發行項
02/28/2013

呼叫此成員函式傳回回應或要求標頭從 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;

參數

dwInfoLevel
指定所要求的資訊類型查詢的屬性組合和下列旗標:
- HTTP_QUERY_CUSTOM 尋找標頭名稱並傳回在 lpvBuffer 的這個值在輸出。 HTTP_QUERY_CUSTOM 擲回判斷提示是否找不到標題。
- HTTP_QUERY_FLAG_REQUEST_HEADERS 一般，應用程式會查詢回應標頭，您可以使用這個旗標，不過，應用程式也可以查詢要求標頭。
- 值是日期/時間字串，例如「最後修改時間，」這個旗標會傳回標頭值的標頭HTTP_QUERY_FLAG_SYSTEMTIME ，因為不需要應用程式剖析資料的標準 SYSTEMTIME Win32 結構。如果您使用這個旗標，您可能會想要使用函式的 SYSTEMTIME 覆寫。
- 這個值是一個數字，例如狀態碼，這個旗標會傳回資料的為 32 位元數值的標頭HTTP_QUERY_FLAG_NUMBER 。
的可能值清單中看到備註部分。
lpvBuffer
要取得資訊的緩衝區指標。
lpdwBufferLength
在輸入時，這點至資料緩衝區的長度值，總字元或位元組。請參閱備註章節以取得這個參數的詳細資訊。
lpdwIndex
為以零起始的標頭索引的指標。可以是 NULL。使用這個旗標列舉型別有多個相同名稱的標頭。進入時， lpdwIndex 表示指定的標題中物件傳回。在輸出， lpdwIndex 表示 [下一頁首的索引。如果找不到下一個索引， ERROR_HTTP_HEADER_NOT_FOUND 傳回。
str
out 接收所傳回的資訊 CString 物件的參考。
dwIndex
索引值。請參閱 lpdwIndex。
pSysTime
SYSTEMTIME Win32 結構的指標。