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 |