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 関数