ATDV_ERRMSGP( )

Description | Example | Errors | See Also

Name:	char * ATDV_ERRMSGP(dev)
Inputs:	int dev	valid Dialogic device handle
Returns:	pointer to string
Includes:	srllib.h
Category:	standard attribute

Description

The ATDV_ERRMSGP( ) function returns a pointer to an ASCIIZ string that describes the last error that occurred on this device. This pointer remains valid throughout the execution of the application. If no error occurred on the device during the last function call, the string pointed to is "No Error".

Parameter	Description
dev	Device handle, the handle returned by the technology-specific xx_open( ).

Example

#include <windows.h>  
   
#include <srllib.h>  
#include <dxxxlib.h>  
main()  
{  
   int dxxxdev;  
     int parm = ET_RON;
  
     /* Open dxxx channel device */  
   if(( dxxxdev = dx_open( "dxxxB1C1", 0 )) == -1 ){  
      printf( "Error: cannot open device\n" );  
      exit( 1 );  
   }
  
     /*Attempt to set a board level parameter on a channel device-will fail */  
     if( dx_setparm( dxxxdev, DXBD_R_EDGE, &parm ) == -1 ){  
          printf( "The last error on the device was '%s'\n",  
                     ATDV_ERRMSGP( dxxxdev ));  
     }  
}

Errors

This function returns a pointer to the string "Unknown device" if an invalid device handle is specified in dev.

See Also

• The appropriate technology-specific Programmer's Guide

Click here to contact Dialogic Customer Engineering