WNetSetLastErrorW 函数 (npapi.h)

设置扩展的错误信息。 网络提供商应调用此函数,而不是 SetLastError

如有必要, 多提供程序路由器 (MPR) 调用 SetLastError 来设置从网络提供程序返回的 Windows 错误。

语法

void WNetSetLastErrorW(
  [in] DWORD  err,
  [in] LPWSTR lpError,
  [in] LPWSTR lpProviders
);

参数

[in] err

发生的错误。 这是特定于网络的错误代码。

[in] lpError

描述网络特定错误的字符串。

[in] lpProviders

命名引发错误的网络提供程序的字符串。

返回值

备注

此函数由 Windows 操作系统实现,可由网络提供程序调用。

提供程序应使用此函数报告包含提供程序特定信息的错误。 将保存错误信息,直到在同一线程中被另一次调用 WNetSetLastError 覆盖。

提供程序函数处理常规错误的推荐方法是使用以下语句。

return(providerError);

在此语句中,providerError 是 Windows 错误代码,例如本文档中为提供程序 API 列出的返回代码之一。

对于特定于提供程序的错误,提供程序应执行以下操作。

//  Set up lpErrorString to be the error to be reported.
WNetSetLastError(providerError,
lpErrorString,
lpProviderName);
return(ERROR_EXTENDED_ERROR);

在这种情况下,providerError 是特定于提供程序的错误代码。

提供程序无需在从提供程序函数返回之前调用 SetLastError 。 如有必要,MPR 会调用 SetLastError 来设置从提供程序返回的 Windows 错误以满足应用程序的需求。

要求

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