Subrutina odm_err_msg
Finalidad
Devuelve una serie de mensaje de error.
Biblioteca
Biblioteca del gestor de datos de objetoslibodm.a)
Sintaxis
#include <odmi.h>Descripción
La subrutina odm_err_msg toma como entrada un parámetro ODMErrno y una dirección en la que poner el puntero de la cadena de mensajes que corresponde al número de error ODM introducido. Si no se encuentra ningún mensaje correspondiente para el número de error de entrada, se devuelve una serie nula y la subrutina no es satisfactoria.
Parámetros
| Elemento | Descripción |
|---|---|
| ODMErrno | Especifica el código de error para el que se recupera la serie de mensaje. |
| MessageString | Especifica la dirección de un puntero de serie que apuntará a la serie de mensaje de error devuelta. |
Valores de retorno
Tras la finalización satisfactoria, se devuelve un valor de 0. Si la subrutina odm_err_msg no tiene éxito, se devuelve un valor de -1, y el valor MessageString devuelto es una cadena nula.
Ejemplos
El siguiente ejemplo muestra el uso de la subrutina odm_err_msg:
#include <odmi.h>
char *error_message;
...
/*--------------------------------------------------------------*/
/*ODMErrno was returned from a previous ODM subroutine call.*/
/*--------------------------------------------------------------*/
returnstatus = odm_err_msg ( odmerrno, &error_message );
if ( returnstatus < 0 )
printf ( "Retrieval of error message failed\n" );
else
printf ( error_message );