Функция SetLastError (errhandlingapi.h)

  • Статья

Задает код последней ошибки для вызывающего потока.

Синтаксис

void SetLastError(
  [in] DWORD dwErrCode
);

Параметры

[in] dwErrCode

Код последней ошибки для потока.

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

None

Remarks

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

Большинство функций вызывают SetLastError или SetLastErrorEx только в случае сбоя. Однако некоторые системные функции вызывают SetLastError или SetLastErrorEx в условиях успешного выполнения. Эти случаи указаны в документации по каждой функции.

При необходимости приложения могут получить значение, заданное этой функцией, с помощью функции GetLastError сразу после сбоя функции.

Кодами ошибок являются 32-разрядные значения (бит 31 является наиболее значимым битом). Бит 29 зарезервирован для кодов ошибок, определяемых приложением; Этот бит не задан в коде системной ошибки. Если вы определяете код ошибки для приложения, задайте этот бит, чтобы указать, что код ошибки определен приложением, и убедиться, что код ошибки не конфликтует ни с какими системными кодами ошибок.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header errhandlingapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

Функции обработки ошибок

Getlasterror

Код последней ошибки

SetLastErrorEx

API-интерфейсы Vertdll, доступные в анклавах VBS