InternetGetLastResponseInfoA 関数 (wininet.h)

  • [アーティクル]

この関数を呼び出すスレッドの最後のエラー記述またはサーバー応答を取得します。

構文

BOOL InternetGetLastResponseInfoA(
  [out]     LPDWORD lpdwError,
  [out]     LPSTR   lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength
);

パラメーター

[out] lpdwError

失敗した操作に関連するエラー メッセージを受け取る変数へのポインター。

[out] lpszBuffer

エラー テキストを受け取るバッファーへのポインター。

[in, out] lpdwBufferLength

TCHAR 内の lpszBuffer バッファーのサイズを含む変数へのポインター。 関数が戻るときに、このパラメーターには、バッファーに書き込まれた文字列のサイズが含まれます。終端の 0 は含まれません。

戻り値

エラー テキストがバッファーに正常に書き込まれた場合は TRUE 、それ以外の場合は FALSE を 返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 バッファーが小さすぎてすべてのエラー テキストを保持できない場合、 GetLastError は ERROR_INSUFFICIENT_BUFFERを返し、 lpdwBufferLength パラメーターには、すべてのエラー テキストを返すために必要な最小バッファー サイズが含まれています。

注釈

FTP プロトコルは、ほとんどのエラーと共に追加のテキスト情報を返すことができます。 この拡張エラー情報は、GetLastError が (失敗した関数呼び出しの後に発生した) ERROR_INTERNET_EXTENDED_ERRORを返すたびに、InternetGetLastResponseInfo 関数を使用して取得できます。

lpszBuffer が指すバッファーは、エラー文字列と 0 終端記号の両方を文字列の末尾に保持するのに十分な大きさにする必要があります。 ただし、 lpdwBufferLength で返される値には終端の 0 は含まれないことに注意してください。

InternetGetLastResponseInfo は、このスレッドで別の関数が呼び出されるまで複数回呼び出すことができます。 別の関数が呼び出されると、最後の応答情報を格納している内部バッファーがクリアされます。

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

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

注意

wininet.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetGetLastResponseInfo を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

一般的な関数

WinINet 関数