ATFX_TFBADTAG( )

Description | Example | Errors

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

Description

The ATFX_TFBADTAG( ) function returns the invalid TIFF/F tag number when ATDV_LASTERR( ) returns an EFX_BADTAG error. This error is returned during the transmission of a TIFF/F file if an invalid TIFF/F tag value is found.

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

The invalid TIFF/F tag value returned by ATFX_TFBADTAG( ) 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_BADTAG) {  
      printf("Bad Tag in TIFF/F file. Tag number %ld\n",  
         ATFX_TFBADTAG(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