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

要求

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

另请参阅

Windows 网络 (WNet) 概述

Windows 网络函数