SetupAddInstallSectionToDiskSpaceList

[New for Windows NT 4.0 Service Pack 3.]

The SetupAddInstallSectionToDiskSpaceList function searches for CopyFile and DelFile lines in an Install section of an INF file. The function then adds the file operations specified in those sections to a disk-space list.

BOOL SetupAddInstallSectionToDiskSpaceList(
  HDSKSPC DiskSpace,     // handle to the disk-space list
  HINF InfHandle,        // handle to the INF
  HINF LayoutInfHandle,  // optional, handle to the layout INF
  PCTSTR SectionName,    // specifies the Install section
  PVOID Reserved1,       // must be zero
  UINT Reserved2         // must be zero
);
 

Parameters

DiskSpace

Supplies a handle to a disk-space list.

InfHandle

Supplies a handle to an open INF file that contains the Install section to be searched. If ListInfHandle is not specified, the INF file must also contain the section specified by SectionName. This handle must be for a Window 95- or Windows NT 4.0-style INF file.

LayoutInfHandle

This parameter, if specified, provides the handle to the INF file that contains the SourceDisksFiles section(s). Otherwise that section is assumed to exist in the INF file specified by InfHandle.

SectionName

Supplies the name of the Install section to add to the disk-space list.

Reserved1

Must be 0.

Reserved2

Must be 0.

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.

QuickInfo

  Windows NT: Use version 4.0 SP3 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, SetupAddSectionToDiskSpaceList, SetupAddToDiskSpaceList, SetupRemoveInstallSectionFromDiskSpaceList