次の方法で共有

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

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

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

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

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wininet.h
ライブラリ Wininet.lib
DLL Wininet.dll

関連項目

共通関数の

WinINet Functions の