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