通过

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 标头将 WNetGetLastError 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 winnetwk.h
库 Mpr.lib
DLL Mpr.dll

另请参阅

Windows 网络（WNet）概述

Windows 网络函数