SetupQueueCopySection
The SetupQueueCopySection function places all the files in a section of an INF file in a setup queue for copying. The section must be in the correct Copy Files format and the INF file must contain SourceDisksFiles and SourceDisksNames sections (or have had the INF files containing those sections appended).
BOOL SetupQueueCopySection(
HSPFILEQ QueueHandle, // handle of the file queue
PCTSTR SourceRootPath, // path to the source media
HINF InfHandle, // handle to the master INF file
HINF ListInfHandle, // optional, handle to section INF
PCTSTR Section, // INF section w/files to copy
DWORD CopyStyle // specifies copy behavior
);
Parameters
-
QueueHandle
-
Supplies a handle to a setup file queue, as returned by SetupOpenFileQueue.
-
SourceRootPath
-
Supplies the root of the source for this copy, such as A:\.
-
InfHandle
-
This optional parameter points to the handle of an open INF file that contains the SourceDisksFiles and SourceDisksNames sections, and, if ListInfHandle is not specified, contains the section names. If platform-specific sections exist for the user's system (for example, SourceDisksNames.mips and SourceDisksFiles.mips), the platform-specific section will be used. This handle must be for a Windows 95- or Windows NT 4.0-style INF file.
-
ListInfHandle
-
If specified, supplies a handle to an open INF file that contains the section to queue for copying. If ListInfHandle is not specified, InfHandle is assumed to contain the section.
-
Section
-
Supplies the name of the section to be queued for copy.
-
CopyStyle
-
Flags that control the behavior of the file copy operation. These flags may be a combination of the following values:
-
SP_COPY_DELETESOURCE
-
Delete the source file upon successful copy. The caller is not notified if the delete fails.
-
SP_COPY_REPLACEONLY
-
Copy the file only if doing so would overwrite a file at the destination path.
-
SP_COPY_NEWER
-
Examine each file being copied to see if its version resources indicate that it is not newer than an existing copy on the target.
The file version information used during version checks is that specified in the dwFileVersionMS and dwFileVersionLS members of a VS_FIXEDFILEINFO structure, as filled in by the Win32 version functions. If one of the files does not have version resources, or if they have identical version information, the source file is considered newer.
If the source file is not newer, and CopyMsgHandler is specified, the caller is notified and may cancel the copy. If CopyMsgHandler is not specified, the file is not copied.
-
SP_COPY_NOOVERWRITE
-
Check whether the target file exists, and, if so, notify the caller who may veto the copy. If CopyMsgHandler is not specified, the file is not overwritten.
-
SP_COPY_NODECOMP
-
Do not decompress the file. When this flag is set, the target file is not given the uncompressed form of the source name (if appropriate). For example, copying f:\mips\cmd.ex_ to \\install\temp results in a target file of \\install\temp\cmd.ex_. If the SP_COPY_NODECOMP flag was not specified, the file would be decompressed and the target would be called \\install\temp\cmd.exe. The filename part of DestinationName, if specified, is stripped and replaced with the filename of the source file. When SP_COPY_NODECOMP is specified, SP_COPY_LANGUAGEAWARE and SP_COPY_NEWER are ignored.
-
SP_COPY_LANGUAGEAWARE
-
Examine each file being copied to see if its language differs from the language of any existing file already on the target. If so, and CopyMsgHandler is specified, the caller is notified and may cancel the copy. If CopyMsgHandler is not specified, the file is not copied.
-
SP_COPY_SOURCE_ABSOLUTE
-
SourceFile is a full source path. Do not look it up in the SourceDisksNames section of the INF file.
-
SP_COPY_SOURCEPATH_ABSOLUTE
-
SourcePathRoot is the full path part of the source file. Ignore the relative source specified in the SourceDisksNames section of the INF file for the source media where the file is located. This flag is ignored if SP_COPY_SOURCE_ABSOLUTE is specified.
-
SP_COPY_FORCE_IN_USE
-
If the target exists, behave as if it is in use and queue the file for copying on the next system reboot.
-
SP_COPY_IN_USE_NEEDS_REBOOT
-
If the file was in use during the copy operation, alert the user that the system needs to be rebooted.
-
SP_COPY_NOSKIP
-
Do not give the user the option to skip a file.
-
SP_COPY_FORCE_NOOVERWRITE
-
Check whether the target file exists, and, if so, the file is not overwritten. The caller is not notified.
-
SP_COPY_FORCE_NEWER
-
Examine each file being copied to see if its version resources (or timestamps for non-image files) indicate that it is not newer than an existing copy on the target. If the file being copied is not newer, the file is not copied. The caller is not notified.
-
SP_COPY_WARNIFSKIP
-
If the user tries to skip a file, warn them that skipping a file may affect the installation. (Used for system-critical files.)
Return Values
If the function succeeds, the return value is a non-zero value.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
If a UNC directory is specified as the target directory of a file copy operation, you must ensure it exists before the queue is committed. The setup functions do not check for the existence of and do not create UNC directories. If the target UNC directory does not exist, the file copy will fail.
QuickInfo
Windows NT: Use version 4.0 and later.
Windows: Use Windows 95 and later.
Windows CE: Unsupported.
Header: Declared in setupapi.h.
Import Library: Link with setupapi.lib.
See Also
Overview, Functions, SetupQueueCopy, SetupQueueDefaultCopy