ATFX_ESTAT( )

Description | Example | Errors

Name:	long ATFX_ESTAT(dev)
Inputs:	int dev	fax channel device handle
Returns:	Phase E information if successful
	AT_FAILURE if error
Includes:	srllib.h
	dxxxlib.h
	faxlib.h
Category:	extended attribute
Mode:	synchronous

Description

The ATFX_ESTAT( ) function returns Phase E information describing errors that occurred during the T.30 fax protocol.

When the fx_rcvfax( ), fx_rcvfax2( ) or fx_sendfax( ) function returns a -1, or ATDV_LASTERR( ) returns a EFX_DISCONNECT error, use this function to determine the reason for disconnection. See Appendix C for Phase E values returned.

If a T.30 protocol error does not occur, ATFX_ESTAT( ) returns a zero.

Parameter	Description
dev	Specifies the channel device handle for the fax channel obtained when the channel was opened.

Example

#include <stdio.h>  
#include <windows.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <faxlib.h>  
DF_IOTT iott[10];  
int dev;  
/*  
 * Open the channel using fx_open( ) and obtain the Dialogic  
 * FAX device handle in dev.  
 */  
.  
.  
/* Call fx_sendfax( ) after setting up the DF_IOTT array. */  
if (fx_sendfax(dev, iott, EV_SYNC) == -1) {  
   printf("Error - %s (error code %d)\n",  
      ATDV_ERRMSGP(dev),ATDV_LASTERR(dev));  
   if (ATDV_LASTERR(dev)==EDX_SYSTEM) {  
      /* Perform system error processing */  
   }   else if (ATDV_LASTERR(dev) == EFX_DISCONNECT) {  
      /*  
       * Additional error processing - check Phase E status to  
       * determine cause of error during fax protocol.  
       */  
      printf("Phase E status: %ld\n", ATFX_ESTAT(dev));  
      }  
}  
.  
.

Errors

This function fails and returns AT_FAILURE if an invalid fax channel device handle is specified in dev.

Click here to contact Dialogic Customer Engineering