Share via

_UserError( ) (Rutina de biblioteca API)

  • Artículo

Indica un error con texto terminado en nulo que se especifica con message.

void _UserError(char FAR *message)
char FAR *message;         /* Error message. */

Observaciones

El código interno de Visual FoxPro de este error es 98. El código devuelto por la función ERROR( ) de Visual FoxPro es 1098. La función MESSAGE( ) de Visual FoxPro devuelve al usuario el mensaje message que especifique. El control se pasa al controlador de errores de Visual FoxPro y no vuelve.

Nota   No llame a _UserError( ) en una rutina CALLUNLOAD, ya que la biblioteca no se cargará debido a la llamada de _UserError( ); no se mostrará ningún mensaje.

Para obtener más información acerca de cómo crear una biblioteca API e integrarla con Visual FoxPro, vea Acceso a la API de Visual FoxPro.

Ejemplo

El ejemplo siguiente llama a _UserError( ), lo que demuestra que la ejecución no vuelve a la rutina API después de _UserError( ).

Código Visual FoxPro

SET LIBRARY TO EXAMPLE
= EXAMPLE()

Código C

#include <pro_ext.h>

FAR UserErrorEx(ParamBlk FAR *parm)
{
   _UserError("This is a _UserError() example.");
   _PutStr("This should never be displayed.");
}

FoxInfo myFoxInfo[] = {
   {"EXAMPLE", (FPFI) UserErrorEx, 0, ""},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Vea también

_Error( ) (Rutina de biblioteca API) | _ErrorInfo( ) (Rutina de biblioteca API) | ERROR( ) (Función) | MESSAGE( ) (Función) | Acceso a la API de Visual FoxPro