Summary

 

dfOpenCmpByNames creates new comparing context for two files, descriptors for these files are set in parameters hOldFile and hNewFile.

 

Syntax

 

 

Arguments

 

hOldFile

[Input]

Descriptor of an old file, created by function CreateFile().

May be INVALID_FD_VALUE value, if old file is skipped.

 

hNewFile

[Input]

Descriptor of a new file, created by function CreateFile().

May be INVALID_FD_VALUE value, if new file is skipped.

 

ppCmp

[Output]

Pointer on variable of PTDfCmp type, which contains a pointer on the comparing context created in case of successful function termination.

 

Return Values

 

If the function succeeds, the return value is zero (EDF_SUCCESS).

 

If the function fails, the return value is one of the following:

EDF_BAD_PARAM

EDF_OUT_OF_MEMORY

EDF_SYSERROR

EDF_FATAL

 

Remarks

 

Filling of the context structure fields during the process of difference context creating is processed subject to values of attributes of the compared files (see TDfCmp structure description for details). Fields szOldFileName, szNewFileName, szOldVersionID and szNewVersionID are left empty. You can set values for these fields on your own.

 

Successfully created comparing context can be used later on when calling functions dfCompare, dfBuildN and dfBuildH.

One of files whether an old or a new one can be skipped (value of the descriptor INVALID_FD_VALUE), but not both concurrently.

 

NOTE: Use function dfCloseCmp to delete the context and to free associated resources.

 

See also

TDfCmp, dfOpenCmpByNames, dfCompare, dfCloseCmp