CHttpFile::QueryInfo

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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 "Last-Modified-Time" などの日付/時刻文字列の値を持つヘッダーの場合、このフラグは、ヘッダーの値を Win32 の標準 SYSTEMTIME 構造体として返します。この場合、アプリケーションでデータを解析する必要はありません。このフラグを使用するときは、SYSTEMTIME を使用するように関数をオーバーライドすると便利です。
- HTTP_QUERY_FLAG_NUMBER ステータスコードなどのように値が数値のヘッダーの場合、このフラグは、32 ビットの数値としてデータを返します。
使用できる値の一覧については、「解説」を参照してください。
lpvBuffer
情報を受け取るバッファへのポインタ。
lpdwBufferLength
呼び出し時には、文字数またはバイト数でデータバッファの長さが入っている値へのポインタ。このパラメータの詳細については、「解説」を参照してください。
lpdwIndex
0 から始まるヘッダーインデックスへのポインタ。NULL の場合もあります。同一名の複数のヘッダーを列挙するために使用します。入力時の lpdwIndex は、返されるヘッダーのインデックスを示します。出力時の lpdwIndex は、次のヘッダーのインデックスを示します。次のインデックスが見つからない場合、ERROR_HTTP_HEADER_NOT_FOUND が返されます。
str
返される情報を受け取る CString オブジェクトへの参照。
dwIndex
インデックス。lpdwIndex を参照してください。
pSysTime
Win32 の SYSTEMTIME 構造体へのポインタ。