set_terminate (CRT)

Artículo
06/09/2015

Instala poseen la rutina de finalización que se denomine por terminate.

terminate_function set_terminate(
   terminate_function termFunction
);

Parámetros

termFunction
Puntero a una función de terminación que escribe.

Valor devuelto

Devuelve un puntero a la función anterior registrada por set_terminate para poder restaurar la función anterior más adelante. Si no se ha establecido ninguna función anterior, el valor devuelto se puede utilizar para restaurar el comportamiento predeterminado; este valor puede ser NULL.

Comentarios

La función de set_terminate instala termFunction como la función llamada por terminate. set_terminate se utiliza con el control de excepciones de C++ y se puede llamar en cualquier punto del programa antes de que se produzca la excepción. llamadas abort determinate de forma predeterminada. Puede cambiar este valor predeterminado escribiendo dispone de la función de finalización y llamando set_terminate con el nombre de la función como argumento. terminate llama a la función última especificada como argumento a set_terminate. Después de realizar las tareas deseadas de limpieza, termFunction debe salir del programa. Si no sale (si vuelve a su llamador), se llama a abort .

En un entorno multiproceso, finalice las funciones se mantienen por separado para cada subproceso. Cada nuevo subproceso necesita instalar sus propios finaliza la función. Así, cada subproceso está responsable de su propio control de finalización.

Define el tipo de terminate_function en EH.H como puntero a una función definida por el usuario de finalización, termFunction que devuelve void. La función personalizada termFunction no puede tomar ningún argumento y no debe volver al llamador. Si lo hace, se llama abort . Una excepción no puede producirse dentro de termFunction.

typedef void ( *terminate_function )( );

Nota
La función de set_terminate sólo funciona fuera del depurador.

Hay solo controlador de set_terminate para todos los archivos DLL o EXE dinámicamente vinculados; incluso si llama a set_terminate el controlador puede reemplazar por otro, o puede reemplazar un controlador establecido por otra DLL o EXE.

Esta función no se admite en /clr:pure.