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 |