ATFX_TFNOTAG( )

Description | Example | Errors

Name:	long ATFX_TFNOTAG(dev)
Inputs:	int dev	fax channel device handle
Returns:	missing TIFF/F mandatory tag number if successful
	AT_FAILURE if error
Includes:	srllib.h
	dxxxlib.h
	faxlib.h
Category:	extended attribute
Mode:	synchronous

Description

The ATFX_TFNOTAG( ) function returns missing TIFF/F mandatory tag number if ATDV_LASTERR( ) returns an EFX_BADTIF error.

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

The missing TIFF/F tag value returned by ATFX_TFNOTAG( ) 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;  
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. */  
if (fx_sendfax(dev, &iott, EV_SYNC) == -1) {  
   if (ATDV_LASTERR(dev) == EFX_BADTIF) {  
      printf("Missing Tag in TIFF/F file. Tag number %ld\n",  
         ATFX_TFNOTAG(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