Share via

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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winnetwk.h
程式庫 Mpr.lib
Dll Mpr.dll

另請參閱

Windows 網路 (WNet) 概觀

Windows 網路功能