Функция WNetGetLastErrorA (winnetwk.h)

  • Статья

Функция WNetGetLastError извлекает последний расширенный код ошибки, заданный функцией WNet. Поставщик сети сообщил об этом коде ошибки; Как правило, это не будет одна из ошибок, включенных в файл заголовка пакета SDK WinError.h.

Синтаксис

DWORD WNetGetLastErrorA(
  [out] LPDWORD lpError,
  [out] LPSTR   lpErrorBuf,
  [in]  DWORD   nErrorBufSize,
  [out] LPSTR   lpNameBuf,
  [in]  DWORD   nNameBufSize
);

Параметры

[out] lpError

Указатель на переменную, получающую код ошибки, сообщаемый поставщиком сети. Код ошибки зависит от поставщика сети.

[out] lpErrorBuf

Указатель на буфер, который получает строку, завершающуюся значением NULL, описывающую ошибку.

[in] nErrorBufSize

Размер буфера, на который указывает параметр lpErrorBuf , в символах. Если буфер слишком мал для строки ошибки, строка усекается, но по-прежнему заканчивается null. Рекомендуется использовать буфер не менее 256 символов.

[out] lpNameBuf

Указатель на буфер, который получает строку, завершающуюся значением NULL, идентифицируя поставщика сети, вызвавшим ошибку.

[in] nNameBufSize

Размер буфера, на который указывает параметр lpNameBuf , в символах. Если буфер слишком мал для строки ошибки, строка усекается, но по-прежнему заканчивается null.

Возвращаемое значение

Если функция выполнена успешно и она получает последнюю ошибку, о чем сообщил поставщик сети, возвращаемое значение будет NO_ERROR.

Если вызывающий объект предоставляет недопустимый буфер, возвращаемое значение будет ERROR_INVALID_ADDRESS.

Комментарии

Функция WNetGetLastError извлекает ошибки, относящиеся к поставщику сети. WNetGetLastError можно вызвать, когда функция WNet возвращает ERROR_EXTENDED_ERROR.

Как и функция GetLastError , WNetGetLastError возвращает расширенные сведения об ошибке, которые сохраняются для каждого потока. В отличие от GetLastError, функция WNetGetLastError может возвращать строку для отчетов об ошибках, которые не описаны ни в одном существующем коде ошибки в WinError.h.

Дополнительные сведения об использовании определяемого приложением обработчика ошибок, который вызывает функцию WNetGetLastError , см. в разделе Извлечение сетевых ошибок.

Примечание

Заголовок winnetwk.h определяет WNetGetLastError в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winnetwk.h
Библиотека Mpr.lib
DLL Mpr.dll

См. также раздел

Общие сведения о сети Windows (WNet)

Сетевые функции Windows