SetupQueueRenameSection

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 DestinationDirs 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 a non-zero value.

If the function fails, the return value is zero. 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.

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, SetupQueueCopySection, SetupQueueDeleteSection, SetupQueueRename