ATFX_LASTIOTT( )

Description | Example | Errors

Name:	DF_IOTT * ATFX_LASTIOTT(dev)
Inputs:	int dev	fax channel device handle
Returns:	pointer to last DF_IOTT if successful
	AT_FAILUREP if error
Includes:	srllib.h
	dxxxlib.h
	faxlib.h
Category:	extended attribute
Mode:	synchronous

Description

The ATFX_LASTIOTT( ) function returns a pointer to the last processed DF_IOTT structure.

Use this function to determine which DF_IOTT was processed when an error occurred.

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];  
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

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

Click here to contact Dialogic Customer Engineering