InternetGetLastResponseInfoA 函式 (wininet.h)
擷取呼叫此函式的線程上最後一個錯誤描述或伺服器回應。
語法
BOOL InternetGetLastResponseInfoA(
[out] LPDWORD lpdwError,
[out] LPSTR lpszBuffer,
[in, out] LPDWORD lpdwBufferLength
);
參數
[out] lpdwError
變數的指標,該變數收到與失敗之作業相關的錯誤訊息。
[out] lpszBuffer
接收錯誤文字之緩衝區的指標。
[in, out] lpdwBufferLength
變數的指標,其中包含 TCHAR 中 lpszBuffer 緩衝區的大小。 當函式傳回時,此參數會包含寫入緩衝區的字串大小,不包括終止零。
傳回值
如果錯誤文字已成功寫入緩衝區,則傳回 TRUE ,否則傳回 FALSE 。 若要取得擴充的錯誤資訊,請呼叫 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 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wininet.h |
程式庫 | Wininet.lib |
Dll | Wininet.dll |