InternetGetLastResponseInfoW

本関数を呼び出したスレッド上での最後のエラー説明またはサーバーレスポンスを取得する。(Unicode)

InternetGetLastResponseInfoW lpdwError, lpszBuffer, lpdwBufferLength

lpdwError : [var] 失敗した操作に関連するエラーメッセージを受け取る変数へのポインタ。
lpszBuffer : [wstr] エラーテキストを受け取るバッファへのポインタ。
lpdwBufferLength : [var] lpszBuffer バッファのサイズ (TCHAR 単位) を格納する変数へのポインタ。関数が戻ると、本パラメータにはバッファに書き込まれた文字列のサイズ (終端の 0 を含まない) が格納される。

(プラグイン / モジュール : wininet.dll)

解説

本関数を呼び出したスレッド上での最後のエラー説明またはサーバーレスポンスを取得する。(Unicode)

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

[備考]
FTP プロトコルはほとんどのエラーとともに追加のテキスト情報を返すことができる。この拡張エラー情報は、(失敗した関数呼び出しの後に)
GetLastError が ERROR_INTERNET_EXTENDED_ERROR
を返すたびに、InternetGetLastResponseInfo 関数を使用して取得できる。lpszBuffer
が指すバッファは、エラー文字列と末尾のゼロ終端の両方を保持できる十分な大きさでなければならない。ただし、lpdwBufferLength
に返される値は終端のゼロを含まないことに注意。InternetGetLastResponseInfo
は、本スレッドで別の関数が呼び出されるまで複数回呼び出すことができる。別の関数が呼び出されると、最後のレスポンス情報を保存する内部バッファはクリアされる。WinINet
API の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは InternetGetLastResponseInfo
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報