WNetGetLastError函数检索由Windows网络功能设置的最新的扩展错误代码。
DWORD WNetGetLastError(
LPDWORD 【// pointer to error code】, | //指向错误代码 |
LPTSTR 【lpErrorBuf】, | //指向字符串描述错误的指针 |
DWORD 【nErrorBufSize】, | //描述缓冲区的大小,以字符为单位 |
LPTSTR 【lpNameBuf】, | //指向缓冲区的提供程序名称 |
DWORD 【nNameBufSize】 | //提供商名称缓冲区的大小 |
); |
参数
【// pointer to error code】
指向接收网络提供商报告的错误代码的变量。错误代码特定于网络提供商。
【lpErrorBuf】
指向缓冲区,它接收描述错误的以null结尾的字符串。
【nErrorBufSize】
指定【lpErrorBuf】参数指向的缓冲区的大小(以字符为单位)。如果缓冲区对于错误字符串来说太小,则字符串将被截断,但仍以空终止。建议至少256个字符的缓冲区。
【lpNameBuf】
指向缓冲区,它接收标识引发错误的网络提供程序的以空值终止的字符串。
【nNameBufSize】
指定由【lpNameBuf】参数指向的缓冲区的大小(以字符为单位)。如果缓冲区对于错误字符串来说太小,则字符串将被截断,但仍以空终止。
返回值
如果函数成功获取提供程序报告的最后一个错误,返回值为NO_ERROR。如果调用者提供无效的缓冲区,则为ERROR_INVALID_ADDRESS。
备注
WNetGetLastError用于获取特定于网络提供商的错误。当Windows网络功能(或GetLastError功能))返回ERROR_EXTENDED_ERROR时,应该使用它。像GetLastError一样,该函数返回扩展错误信息,该信息在每个线程的基础上进行维护。与GetLastError不同,WNetGetLastError函数也可以返回一个字符串,用于报告错误,这些错误不会被任何现有的错误代码描述。
也可以看看