LIBDF Functions: dfTouch

Summary

 

dfTouch performs updating of all file parts except its content.

 

Syntax

 

int dfTouch (

 

TDfHandle

hDf,

_TCHAR const *

szNewFileName,

int

iApplyFlags );

 

Arguments

 

hDf

[Input]

Special df-file descriptor, created by dfOpenDfFile function.

 

szNewFileName

[Input]

Name of a new file.

Can be NULL, if new file was skipped when creating df-file.

 

iApplyFlags

[Input]

Flags which define the procedure of df-file applying.

Possible values are: "0" or free combination of the following flags:

 

DFAF_DONT_CHG_DATETIME

Do not change last modification date/time of the new file.

If new file already exists then its last modification date/time is not changed.

Otherwise an old file's last modification date/time is taken.

DFAF_DONT_CHG_ATTR

Same as for DFAF_DONT_CHG_DATETIME, but for the value of new file's attributes.

 

Default value: "0".

 

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_FATAL

EDF_SYSERROR

EDF_NEW_OPEN_ERROR

 

Remarks

 

Updating of the new file is performed only in case of this updating is defined in df-file and not masked by flags in iApplyFlags parameter.

If a new file was skipped when creating df-file, then function does nothing and returns EDF_SUCCESS.

 

See also

dfCloseDfFile, dfGetDfInfo, dfApplyN, dfApplyH

 

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