WNetSetLastErrorA 函数 (npapi.h)

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

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

语法

void WNetSetLastErrorA(
  [in] DWORD err,
  [in] LPSTR lpError,
  [in] LPSTR 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