LIBDF Functions: dfOpenCmpByNames

Summary

 

dfOpenCmpByNames creates new comparing context for two files, names of these file are set in parameters szOldFileName and szNewFileName.

 

Syntax

 

int dfOpenCmpByNames (

 

_TCHAR const *

szOldFileName,

_TCHAR const *

szNewFileName,

int

bExtractPEVersions,

PTDfCmp *

ppCmp );

 

 

Arguments

 

szOldFileName

[Input]

A pointer to a null-terminated string that specifies the name of an old file.

Can be NULL or empty string.

 

szNewFileName

[Input]

A pointer to a null-terminated string that specifies the name of a new file.

Can be NULL or empty string.

 

bExtractPEVersions

[Input]

Flag which specifies whether an attempt to obtain a version number (which may be stored in the PE-file resources) will be maid.

If value of bExtractPEVersions is not equal to "0", then this attempt is maid and if succeed, then pointers on file version numbers are saved (in a text format) in the fields of the difference context szOldVersionID and szNewVersionID.

 

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_OPEN_ERROR (in case of error opening of an old file)

EDF_NEW_OPEN_ERROR

EDF_OUT_OF_MEMORY

EDF_SYSERROR

EDF_FATAL

 

Remarks

 

Filling of the context structure fields during the process of comparing context creating is processed subject to values of attributes of the compared files (see  TDfCmp structure description for details).

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

Name of an old or new file can be skipped (i.e. set to NULL or left an empty string), but not both concurrently.

 

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

 

See also

TDfCmp, dfOpenCmpByNames, dfCompare, dfCloseCmp

 

Converted from CHM to HTML with chm2web Standard 2.75 (unicode)