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 |