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

Статья
11/20/2024

Функция 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.

Замечания

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

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnetwk.h
библиотеки	Mpr.lib
DLL	Mpr.dll

См. также

Обзор сети Windows (WNet)

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

Поделиться через