# nfxMergeFile

Combines multiple TIFF-F or TIFF-S files into a single TIFF-F or TIFF-S file.

#### Prototype

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 values

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.

#### Events

None.

#### Details

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.

#### See also

nfxCheckTIFF, nfxSplitFile