ATFX_BADPAGE( )

Description | Example | Errors

Name:	long ATFX_BADPAGE(dev)
Inputs:	int dev	fax channel device handle
Returns:	bad page number within DF_IOTT structure if successful
	AT_FAILURE if error
Includes:	srllib.h
	dxxxlib.h
	faxlib.h
Category:	extended attribute
Mode:	synchronous

Description

The ATFX_BADPAGE( ) function returns the fax page number (if error during processing) within the DF_IOTT structure that is being processed when an error occurs.

To determine the last DF_IOTT processed, call the fax extended attribute ATFX_LASTIOTT( ).

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

The value returned by ATFX_BADPAGE( ) at the end of a fax session remains available to the application until a new send is initiated on that channel.

Example

#include <stdio.h>  
#include <windows.h>  
#include <srllib.h>  
#include <dxxxlib.h>  
#include <faxlib.h>  
DF_IOTT iott[10];  
DF_IOTT * lastiotp;  
long pagenum;  
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) {  
   /*  
    * Get pointer to DF_IOTT being processed when error  
    * occurred.  
    */  
   lastiotp = ATFX_LASTIOTT(dev);  
   /*  
    * Page being processed within this DF_IOTT when error  
    * occurred.  
    */  
   pagenum = ATFX_BADPAGE(dev);  
   .  
   .  
}

Errors

If one of the following conditions is present, this function fails and returns AT_FAILURE:

• An invalid fax channel device handle is specified in dev.
• An EFX_BADPAGE error has not occurred during the last call to fx_sendfax( ) on the specified channel.

Click here to contact Dialogic Customer Engineering