Compartilhar via

Função AddVectoredExceptionHandler (errhandlingapi.h)

  • Artigo

Registra um manipulador de exceções vetorizado.

Sintaxe

PVOID AddVectoredExceptionHandler(
  ULONG                       First,
  PVECTORED_EXCEPTION_HANDLER Handler
);

Parâmetros

First

A ordem na qual o manipulador deve ser chamado. Se o parâmetro não for zero, o manipulador será o primeiro manipulador a ser chamado. Se o parâmetro for zero, o manipulador será o último manipulador a ser chamado.

Handler

Um ponteiro para o manipulador a ser chamado. Para obter mais informações, consulte VectoredHandler.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o manipulador de exceção.

Se a função falhar, o valor retornado será NULL.

Comentários

Se o parâmetro First não for zero, o manipulador será o primeiro manipulador a ser chamado até que uma chamada subsequente a AddVectoredExceptionHandler seja usada para especificar um manipulador diferente como o primeiro manipulador.

Se o parâmetro VectoredHandler apontar para uma função em uma DLL e essa DLL for descarregada, o manipulador ainda será registrado. Isso pode levar a erros de aplicativo.

Para cancelar o registro do manipulador, use a função RemoveVectoredExceptionHandler .

Para compilar um aplicativo que usa essa função, defina a macro _WIN32_WINNT como 0x0500 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Exemplos

Para obter um exemplo, consulte Usando um manipulador de exceção vetor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho errhandlingapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Função AddVectoredContinueHandler, função RemoveVectoredExceptionHandler, Tratamento de Exceção Vetorizado, VectoredHandler