CHttpFile::QueryInfo
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 応答ヘッダーを問い合わせて、アプリケーションには、このフラグを使用して、要求ヘッダーを照会できます。
値を日付/時刻文字列、[最終変更時間など、このフラグのヘッダー値を返すため、データを解析するアプリケーションを必要としない標準の Win32 SYSTEMTIME の構造なヘッダーのHTTP_QUERY_FLAG_SYSTEMTIME。このフラグを使用すると、関数の SYSTEMTIME のオーバーライドを使用することもできます。
値が 32 ビット数として数 (ステータス コードのように、このフラグを返すデータなヘッダーのHTTP_QUERY_FLAG_NUMBER。
使用できる値の一覧については [コメント] "を参照してください。
lpvBuffer
情報を受け取るバッファーへのポインター。lpdwBufferLength
文字とバイト数の合計でデータ バッファーの長さを含む値へのエントリ ポイント、この。このパラメーターに関する詳細については [コメント] "を参照してください。lpdwIndex
ゼロ ベースのヘッダーのインデックスへのポインター。NULL の場合もあります。同じ名前を持つ複数のヘッダーを列挙するには、このフラグを使用します。入力時には、lpdwIndex は、をに指定したヘッダーのインデックスを示します。出力に lpdwIndex は、次のヘッダーのインデックスを示します。次のインデックスが見つからない場合 ERROR_HTTP_HEADER_NOT_FOUND が返されます。str
返された情報を受け取る CString のオブジェクトへの参照。dwIndex
インデックス値。「lpdwIndex」を参照してください。pSysTime
Win32 SYSTEMTIME の構造体へのポインター。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。呼び出しが失敗した場合、エラーの原因を判断するために、Win32 関数 GetLastError が呼び出されるかがあります。
解説
SendRequest にまたは正常に OpenURLによって作成された CHttpFile のオブジェクトで正常な呼び出しの後にのみ、このメンバー関数を使用します。
次の QueryInfoからのデータ型を取得できます:
文字列 (既定)
SYSTEMTIME (「データの場合: 」: 「切れます」などのヘッダー)
DWORD ( STATUS_CODE、CONTENT_LENGTHなどの.場合)
文字列がバッファーに書き込まれ、メンバー関数が成功すると、lpdwBufferLength は null の終了文字の 1 文字で他方が文字列の長さが含まれます。
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
必要条件
Header: afxinet.h