dfTouch Function
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.
| 
