Macro GetExceptionInformation
Recupera uma descrição independente do computador de uma exceção e informações sobre o estado do computador que existe para o thread quando a exceção ocorre. Essa função só pode ser chamada de dentro da expressão de filtro de um manipulador de exceção.
Observação
O Compilador de Otimização do Microsoft C/C++ interpreta essa função como uma palavra-chave e seu uso fora da sintaxe apropriada de tratamento de exceções gera um erro do compilador.
Sintaxe
LPEXCEPTION_POINTERS GetExceptionInformation(void);
Parâmetros
Essa macro não tem parâmetros.
Valor retornado
Um ponteiro para uma estrutura EXCEPTION_POINTERS que contém ponteiros para as duas estruturas a seguir:
- EXCEPTION_RECORD estrutura que contém uma descrição da exceção.
- Estrutura CONTEXT que contém as informações de estado do computador.
Comentários
A expressão de filtro (da qual a função é chamada) é avaliada se ocorrer uma exceção durante a execução do bloco __try e determinar se o bloco __except é executado ou não.
A expressão de filtro pode invocar uma função de filtro. A função de filtro não pode chamar GetExceptionInformation. No entanto, o valor retornado de GetExceptionInformation pode ser passado como um parâmetro para uma função de filtro.
Para passar as informações de EXCEPTION_POINTERS para o bloco de manipulador de exceção, a função de filtro ou expressão de filtro deve copiar o ponteiro ou os dados para o armazenamento seguro que o manipulador pode acessar posteriormente.
No caso de manipuladores aninhados, cada expressão de filtro é avaliada até que uma seja avaliada como EXCEPTION_EXECUTE_HANDLER ou EXCEPTION_CONTINUE_EXECUTION. Cada expressão de filtro pode invocar GetExceptionInformation para obter informações de exceção.
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] |
Confira também