Summary
dfTouch performs updating of all file parts except its content.
Syntax
|
int dfTouch (
|
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