InternetGetLastResponseInfoA 函式 (wininet.h)
擷取呼叫此函式的線程上最後一個錯誤描述或伺服器回應。
語法
BOOL InternetGetLastResponseInfoA(
[out] LPDWORD lpdwError,
[out] LPSTR lpszBuffer,
[in, out] LPDWORD lpdwBufferLength
);
參數
[out] lpdwError
變數的指標,該變數收到與失敗之作業相關的錯誤訊息。
[out] lpszBuffer
接收錯誤文字之緩衝區的指標。
[in, out] lpdwBufferLength
變數的指標,其中包含 lpszBuffer 緩衝區的大小,TCHAR。 當函式傳回時,此參數會包含寫入緩衝區的字串大小,不包括終止零。
傳回值
如果錯誤文字成功寫入緩衝區,或 FALSE,則傳回 true TRUE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。 如果緩衝區太小而無法保存所有錯誤文字,GetLastError 會傳回 ERROR_INSUFFICIENT_BUFFER,而且 lpdwBufferLength 參數包含傳回所有錯誤文字所需的最小緩衝區大小。
言論
FTP 通訊協定可以傳回其他文字資訊,以及大部分的錯誤。 每當 GetLastError 傳回 ERROR_INTERNET_EXTENDED_ERROR 時,就可以使用 InternetGetLastResponseInfo 函式來擷取此擴充錯誤資訊(發生在未成功的函式呼叫之後)。
lpszBuffer 所指向的緩衝區 必須夠大,才能在字串結尾保留錯誤字串和零終止符。 不過,請注意,lpdwBufferLength 中傳回的值 不包含終止零。
InternetGetLastResponseInfo 可以多次呼叫,直到在此線程上呼叫另一個函式為止。 呼叫另一個函式時,會清除儲存最後一個回應信息的內部緩衝區。
如同 WinINet API 的其他所有層面,無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。
注意
wininet.h 標頭會根據 UNICODE 預處理器常數的定義,將 InternetGetLastResponseInfo 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | wininet.h |
連結庫 | Wininet.lib |
DLL | Wininet.dll |