Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

WNetGetLastError function

The WNetGetLastError function retrieves the most recent extended error code set by a WNet function. The network provider reported this error code; it will not generally be one of the errors included in the SDK header file WinError.h.

Syntax


DWORD WNetGetLastError(
  _Out_ LPDWORD lpError,
  _Out_ LPTSTR  lpErrorBuf,
  _In_  DWORD   nErrorBufSize,
  _Out_ LPTSTR  lpNameBuf,
  _In_  DWORD   nNameBufSize
);

Parameters

lpError [out]

Pointer to a variable that receives the error code reported by the network provider. The error code is specific to the network provider.

lpErrorBuf [out]

Pointer to the buffer that receives the null-terminated string describing the error.

nErrorBufSize [in]

Size of the buffer pointed to by the lpErrorBuf parameter, in characters. If the buffer is too small for the error string, the string is truncated but still null-terminated. A buffer of at least 256 characters is recommended.

lpNameBuf [out]

Pointer to the buffer that receives the null-terminated string identifying the network provider that raised the error.

nNameBufSize [in]

Size of the buffer pointed to by the lpNameBuf parameter, in characters. If the buffer is too small for the error string, the string is truncated but still null-terminated.

Return value

If the function succeeds, and it obtains the last error that the network provider reported, the return value is NO_ERROR.

If the caller supplies an invalid buffer, the return value is ERROR_INVALID_ADDRESS.

Remarks

The WNetGetLastError function retrieves errors that are specific to a network provider. You can call WNetGetLastError when a WNet function returns ERROR_EXTENDED_ERROR.

Like the GetLastError function, WNetGetLastError returns extended error information, which is maintained on a per-thread basis. Unlike GetLastError, the WNetGetLastError function can return a string for reporting errors that are not described by any existing error code in WinError.h.

For more information about using an application-defined error handler that calls the WNetGetLastError function, see Retrieving Network Errors.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winnetwk.h

Library

Mpr.lib

DLL

Mpr.dll

Unicode and ANSI names

WNetGetLastErrorW (Unicode) and WNetGetLastErrorA (ANSI)

See also

Windows Networking (WNet) Overview
Windows Networking Functions

 

 

Community Additions

ADD
Show:
© 2015 Microsoft