HttpQueryInfoA 関数 (wininet.h)

HTTP 要求に関連付けられているヘッダー情報を取得します。

構文

BOOL HttpQueryInfoA(
  [in]      HINTERNET hRequest,
  [in]      DWORD     dwInfoLevel,
  [in, out] LPVOID    lpBuffer,
  [in, out] LPDWORD   lpdwBufferLength,
  [in, out] LPDWORD   lpdwIndex
);

パラメーター

[in] hRequest

HttpOpenRequest または InternetOpenUrl 関数の呼び出しによって返されるハンドル。

[in] dwInfoLevel

取得する属性と要求を変更するフラグの組み合わせ。 使用できる属性と修飾子の値の一覧については、「 クエリ情報フラグ」を参照してください。

[in, out] lpBuffer

要求された情報を受信するバッファーへのポインター。 このパラメーターは NULL にすることはできません。

[in, out] lpdwBufferLength

エントリ時に、 lpvBuffer が指すバッファーのサイズ (バイト単位) を含む変数へのポインター。

関数が正常に返されると、この変数にはバッファーに書き込まれた情報のバイト数が含まれます。 文字列の場合、バイト数には文字列の終端 の null 文字は含まれません。

関数が
ERROR_INSUFFICIENT_BUFFERの拡張エラー コードで失敗します。lpdwBufferLength が指す変数には、要求された情報を受信するのに十分な大きさのバッファーのサイズ (バイト単位) が含まれています。 呼び出し元のアプリケーションは、このサイズ以上のバッファーを割り当ててから、関数を再度呼び出すことができます。

[in, out] lpdwIndex

同じ名前の複数のヘッダーを列挙するために使用される 0 から始まるヘッダー インデックスへのポインター。 関数を呼び出すとき、このパラメーターは、返される指定されたヘッダーのインデックスです。 関数が戻るときに、このパラメーターは次のヘッダーのインデックスです。 次のインデックスが見つからない場合は、 ERROR_HTTP_HEADER_NOT_FOUND が返されます。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

HttpQueryInfo から次の種類のデータを取得できます。

• 文字列 (既定値)
• SYSTEMTIME (日付の場合)
• DWORD (HTTP_QUERY_FLAG_NUMBERが使用されている場合は、STATUS_CODE、CONTENT_LENGTHなど)

アプリケーションでデータを文字列以外のデータ型として返す必要がある場合は、 dwInfoLevel に渡される属性を持つ適切な修飾子を含める必要があります。

HttpQueryInfo 関数は、ISO-8859-1 文字 (HttpQueryInfoA 関数) の場合は Microsoft Internet エクスプローラー 3.0、ISO-8859-1 文字 (HttpQueryInfoA 関数) の場合はインターネット エクスプローラー 4.0 以降、UTF-16LE 文字に変換された ISO-8859-1 文字では使用できます。(HttpQueryInfoW 関数)。

WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。

要件

こちらもご覧ください

HTTP セッション

HTTP ヘッダーの取得

WinINet 関数