共用方式為

WNetGetLastErrorA 函式 （winnetwk.h）

  • 發行項

WNetGetLastError 函式會擷取 WNet 函式所設定的最新擴充錯誤碼。 網路提供者回報此錯誤碼;它通常不會是 SDK 頭文件 WinError.h 中包含的其中一個錯誤。

語法

DWORD WNetGetLastErrorA(
  [out] LPDWORD lpError,
  [out] LPSTR   lpErrorBuf,
  [in]  DWORD   nErrorBufSize,
  [out] LPSTR   lpNameBuf,
  [in]  DWORD   nNameBufSize
);

參數

[out] lpError

接收網路提供者所報告之錯誤碼之變數的指標。 錯誤碼是網路提供者特有的。

[out] lpErrorBuf

接收描述錯誤之 Null 終止字串之緩衝區的指標。

[in] nErrorBufSize

lpErrorBuf 參數所指向的緩衝區大小，以字元為單位。 如果緩衝區對錯誤字串而言太小，字串會遭到截斷，但仍以 Null 結束。 建議使用至少 256 個字元的緩衝區。

[out] lpNameBuf

接收 Null 終止字串的緩衝區指標，識別引發錯誤的網路提供者。

[in] nNameBufSize

lpNameBuf 參數所指向的緩衝區大小，以字元為單位。 如果緩衝區對錯誤字串而言太小，字串會遭到截斷，但仍以 Null 結束。

傳回值

如果函式成功，而且它會取得網路提供者回報的最後一個錯誤，則傳回值會NO_ERROR。

如果呼叫端提供無效的緩衝區，則傳回值會ERROR_INVALID_ADDRESS。

言論

WNetGetLastError 函式會擷取網路提供者特有的錯誤。 當 WNet 函式傳回ERROR_EXTENDED_ERROR時，您可以呼叫 WNetGetLastError。

就像 getLastError 函式 一樣，WNetGetLastError 會傳回擴充的錯誤資訊，這是以每個線程為基礎維護。 不同於 getLastError，WNetGetLastError 函式可以傳回字串來報告 WinError.h 中任何現有錯誤碼未描述的錯誤。

如需使用呼叫 WNetGetLastError 函式之應用程式定義錯誤處理程式的詳細資訊，請參閱 擷取網路錯誤。

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winnetwk.h
連結庫 Mpr.lib
DLL Mpr.dll

另請參閱

Windows 網路功能 （WNet） 概觀

Windows 網路函式