SetupQueueRenameSection
[New
- Windows NT]
The SetupQueueRenameSection
function queues a section in an INF file for renaming. The section must be in
the correct rename list section format and the INF file must contain a DestinationDirs
section.
BOOL SetupQueueRenameSection(
|
HSPFILEQ QueueHandle, |
// handle to the
file queue |
|
HINF InfHandle, |
// handle to the
INF file |
|
HINF ListInfHandle, |
// optional,
section INF handle |
|
PCTSTR Section |
// section that
lists the files to rename |
|
); |
|
Parameters
QueueHandle
Supplies a
handle to a setup file queue, as returned by SetupOpenFileQueue.
InfHandle
A handle to
the INF file that contains the DestinationDirsWKMUVK section. If ListInfHandle is not
specified, InfHandle contains the section name. This handle must be for
a Windows 95- or Windows NT 4.0-style INF file.
ListInfHandle
This optional
parameter supplies a handle to an INF file that contains the section to queue
for renaming. If ListInfHandle is not specified, InfHandle is
assumed to contain the section name.
Section
Supplies the
name of the section to be queued for renaming.
Return Values
If the
function succeeds, the return value is TRUE.
If the
function fails, the return value is FALSE. To get extended error information,
call GetLastError.
Remarks
You cannot
queue file moves with SetupQueueRenameSection because the form of a
rename list section limits section renaming to within the same directory.
See Also