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 不支援伺服器實作。 此外，它不應該從服務使用。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。
 

注意

wininet.h 標頭會根據 UNICODE 預處理器常數的定義，將 InternetGetLastResponseInfo 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wininet.h
程式庫 Wininet.lib
Dll Wininet.dll

另請參閱

通用函式

WinINet 函式