Функция GetLastError

Функция GetLastError извлекает значение кода последней ошибки вызывающего потока. Код последней ошибки сохраняется при посредстве базового компонента потока. Многие потоки не записывают поверх друг друга коды последней ошибки.

Visual Basic: Прикладные программы должны вызывать err. LastDllError вместо GetLastError.

Величина возвращаемого значения является значение кода последней ошибки вызывающего потока. Функции устанавливают это значение путем вызова функция SetLastError. Раздел Возвращаемые значения каждой статьи справочника по функциям обращает внимание на условия, при которых функция устанавливает код последней ошибки.

Windows 95/98/Me: Функции, которые фактически реализованы в 16-разрядном коде, не устанавливают код последней ошибки. Вы должны игнорировать код последней ошибки, когда вызываете эти функции. Они включают в себя функции управления окном, функции GDI и функции мультимедийных средств. Для функций, которые устанавливают код последней ошибки, Вы не должны надеяться на возврат функцией GetLastError того же самого значения и в среде Windows 95 /98/Me и в среде Windows NT.

Чтобы получить строку  для кодов системных ошибок, используйте функцию FormatMessage. За полным перечнем кодов ошибок, предусмотренных операционной системой, см. статью Коды системных ошибок.

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

Большинство функций, которые устанавливают последнее значение кода ошибки потока, устанавливает его тогда, когда они завершаются ошибкой; несколько функций устанавливают код ошибки, когда они завершаются успешно. Функция, которая завершилась сбоем, обычно указывается кодом ошибки величины возвращаемого значения типа нуля, ПУСТО (NULL) или - (минус)1. Некоторые функции вызывают SetLastError при условии успешного завершения; на такие случаи обращается внимание в статьях справочника для каждой функции.

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

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

Пример смотри в статье Извлечение кода последней ошибки.

Краткий обзор Обработка ошибок, Функции обработки ошибок, FormatMessage, HRESULT_FROM_WIN32, SetLastError, SetLastErrorEx