Combines multiple TIFF-F or TIFF-S files into a single TIFF-F or TIFF-S file.
DWORD nfxMergeFile ( CTAHD ctahd, char output_file_name, DWORD number_input_files, char *input_files[], DWORD *number_of_pages)
Argument |
Description |
ctahd |
Context handle returned by ctaCreateContext. |
output_file_name |
Name of output file. |
number_input_files |
Number of input file names being passed to the function. |
input_files |
Pointer to an array of input file names. |
number_of_pages |
Pointer to the number of pages moved to the output file. |
Return value |
Description |
SUCCESS |
|
CTAERR_BAD_ARGUMENT |
A function argument is invalid. |
CTAERR_FILE_NOT_FOUND |
The specified input file does not exist. |
CTAERR_FILE_OPEN_FAILURE |
Error opening file. |
CTAERR_FILE_READ_FAILURE |
Error reading file. |
CTAERR_FILE_WRITE_FAILURE |
Error writing to file. |
CTAERR_INVALID_CTAHD |
The specified context handle is invalid. |
NFXERR_BAD_FILE_FORMAT |
One of the specified input files is not in TIFF-F or TIFF-S format. |
None.
Although TIFF-F files can contain pages with different attributes, nfxMergeFile copies whole pages from one file to another. It does not convert or examine attributes. All pages in the input files are copied sequentially into a single file named output_file_name. At least one input_file file must exist. The contents of the input files are not modified.
The resulting TIFF-F or TIFF-S output file can have different attributes on different pages.
Use nfxCheckTIFF to examine the attributes of all input files before operating on them with either nfxMergeFile or nfxSplitFile.
Note: Make sure the application continues processing events during an active fax session. If file I/O intensive operations such as merging files interfere with the handling of events, the fax session could time out. The application should process events within three seconds.
Refer to Performing offline image conversion for more information.