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

Статья
03/11/2023

Регистрирует обработчик векторных исключений.

Синтаксис

PVOID AddVectoredExceptionHandler(
  ULONG                       First,
  PVECTORED_EXCEPTION_HANDLER Handler
);

Параметры

First

Порядок вызова обработчика. Если параметр не является нулевым, обработчик является первым вызываемого обработчиком. Если параметр равен нулю, обработчик является последним вызываемого обработчиком.

Handler

Указатель на вызываемого обработчика. Дополнительные сведения см. в разделе VectoredHandler.

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

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

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

Если параметр First не является нулевым, обработчик является первым вызываемым обработчиком, пока последующий вызов AddVectoredExceptionHandler не будет использоваться для указания другого обработчика в качестве первого обработчика.

Если параметр VectoredHandler указывает на функцию в библиотеке DLL и эта библиотека DLL выгружается, обработчик по-прежнему регистрируется. Это может привести к ошибкам приложения.

Чтобы отменить регистрацию обработчика, используйте функцию RemoveVectoredExceptionHandler .

Чтобы скомпилировать приложение, использующее эту функцию, определите макрос _WIN32_WINNT как 0x0500 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Примеры

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

Требования

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

См. также

Функция AddVectoredContinueHandler, Функция RemoveVectoredExceptionHandler, Векторная обработка исключений, VectoredHandler

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