CopyFiles
Other versions of this page are also available for the following:
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
The CopyFiles key, under the [DefaultInstall] section, is required and describes the default files to copy to the target device.
.gif "Aa924416.security(en-US,WinEmbedded.60).gif") Security Note: |
|---|
| If files require protection from being overwritten on the target device by unprivileged applications, before creating the .cab file, make sure that these files are marked as System files on the desktop. The CAB Wizard examines the attributes of each file packed in the .cab file, and honors these attributes when the files are installed on the target device. |
[copyfile_list_section]
destination_filename,[source_filename],[,flags]
[destination_filename,[source_filename],[,flags]]
Parameters
destination_filename
Specifies the name of the destination file.Note
Use only Unicode characters that can be converted into ANSI characters without data loss. This enables backward compatibility with earlier device versions. For more information, see CAB Wizard.
- source_filename
Optional if this is identical to destination_filename.
flags
Contains a numeric value that specifies an action to be done while copying files.The following table shows the values that are supported by Windows Embedded CE.
Flag Value Description COPYFLG_WARN_IF_SKIP
0x00000001
Warn a user if an attempt is made to skip a file after an error occurs.
COPYFLG_NOSKIP
0x00000002
Do not allow a user to skip copying a file.
COPYFLG_NO_OVERWRITE
0x00000010
Do not overwrite a file in the destination directory.
COPYFLG_REPLACEONLY
0x00000400
Copy the source file to the destination directory only if the file is in the destination directory.
CE_COPYFLG_NO_DATE_DIALOG
0x20000000
Do not copy files if the target file is newer.
CE_COPYFLG_NODATECHECK
0x40000000
Ignore date while overwriting the target file.
CE_COPYFLG_SHARED
0x80000000
Create a reference when a shared DLL is counted.
The following [CopyFiles] code example renames Help.htm and warns if it is skipped, while WinGame.wav is renamed and marked as shared:
[DefaultInstall]
CopyFiles = CopyFilesSection
[CopyFilesSection]
"Sample Help.htm",Help.htm,,0x00000001
"Win Game.wav",WinGame.wav,,0x80000000
Remarks
For Windows Mobile, if you want to package a .cab file inside another .cab file, you must also add a custom Setup.dll file to the outer .cab file. This Setup.dll file will install any .cab files that are packaged inside the outer .cab file. For more information, see Optional Setup.dll Files for Installation.**