CHttpFile::QueryInfo

BOOL QueryInfo (DWORD dwInfoLevel、LPVOID lpvBuffer、LPDWORD lpdwBufferLength、LPDWORD lpdwIndex = NULL) const;

BOOL QueryInfo (DWORD dwInfoLevel、CStringamp;strLPDWORDdwIndex= NULL) const;(&A)

BOOL QueryInfo (DWORD dwInfoLevelSYSTEMTIME ※ pSysTime、LPDWORD dwIndex = NULL) const;

戻り値

成功した場合は 0 だ。それ以外の場合は 0 です。呼び出しが失敗した場合は、Win32 関数 GetLastErrorを呼び出してすると、エラーの原因を特定するには。

パラメーター

dwInfoLevel

属性クエリと要求された情報の種類を指定する、次のフラグの組み合わせ:

• HTTP_QUERY_CUSTOM特価;ヘッダー名を検索して出力をlpvBufferにこの値を返します。ヘッダーが見つからない場合、アサーションHTTP_QUERY_CUSTOMがスローされます。(&N)。
  
  
• HTTP_QUERY_FLAG_REQUEST_HEADERS特価;通常、応答ヘッダーのアプリケーションのクエリが、アプリケーションではこのフラグを使用しても、要求ヘッダー照会できます。(&N)。
  
  
• HTTP_QUERY_FLAG_SYSTEMTIME特価;これらのヘッダーの値が「最後-変更時"などの日付と時刻文字列のこのフラグとして標準の Win32 ヘッダー値を返します。 のデータを解析するアプリケーションを必要としないSYSTEMTIME構造体。このフラグを使用する場合は、 SYSTEMTIMEオーバーライド関数を使用したいと思うことがあります。(&N)。
  
  
• HTTP_QUERY_FLAG_NUMBER特価;その値は、ステータス コードなどですこれらのヘッダーをこのフラグ データは 32 ビットの数値として返します(&N)。

  可能な値の一覧については、「解説を参照してください。

lpvBuffer

情報を受け取るバッファーへのポインター。

lpdwBufferLength

エントリには、このデータ バッファーの文字数またはバイト数の長さを表す値を指します。このパラメーターの詳細については、解説を参照してください。

lpdwIndex

0 から始まるヘッダー インデックスへのポインター。NULLにすることができます。このフラグを使用して、同じ名前を持つ複数のヘッダーを列挙します。入力には、 lpdwIndexを返すには、指定したヘッダーのインデックスを示します。出力では、 lpdwIndexの次のヘッダーのインデックスを示します。次のインデックスが見つからない場合は、 ERROR_HTTP_HEADER_NOT_FOUNDが返される。

str

返される情報を受け取るCStringオブジェクトへの参照。

dwIndex

インデックス値。LpdwIndexを参照してください。

pSysTime

Win32 へのポインター SYSTEMTIME構造体。

解説

応答または要求のヘッダーを HTTP リクエストからこのメンバー関数を呼び出しています。このメンバー関数を使用して、 SendRequestを呼び出しまたはOpenURLでは正常に作成、 CHttpFileオブジェクトに成功した呼び出しの後にのみ。

QueryInfoから、次の種類のデータを取得することができます。:

• 文字列 (既定)
  
  
• SYSTEMTIME(の「データ:」「Expires:」など、ヘッダー)
  
  
• 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

CHttpFile 概要|nbsp;クラス メンバー |階層図(&N)

参照特価;CInternetFile、 CHttpConnection::OpenRequest、 CFtpConnection、 CGopherConnection、 CInternetConnection(&N)