Export (0) Print
Expand All
Expand Minimize

SetupAddSectionToDiskSpaceList function

[This function is available for use in the operating systems indicated in the Requirements section. It may be altered or unavailable in subsequent versions. SetupAPI should no longer be used for installing applications. Instead, use the Windows Installer for developing application installers. SetupAPI continues to be used for installing device drivers.]

The SetupAddSectionToDiskSpaceList function adds to a disk-space list all the file delete or copy operations listed in a Copy Files or Delete Files section of an INF file.

Target disk compression is ignored by this function. Files are assumed to occupy their full size on the target disk.

Syntax


BOOL SetupAddSectionToDiskSpaceList(
  _In_  HDSKSPC DiskSpace,
  _In_  HINF InfHandle,
  _In_  HINF ListInfHandle,
  _In_  PCTSTR SectionName,
  _In_  UINT Operation,
  _In_  PVOID Reserved1,
  _In_  UINT Reserved2
);

Parameters

DiskSpace [in]

Handle to the disk-space list.

InfHandle [in]

Handle to an open INF file that contains the SourceDisksFiles section. If ListInfHandle is not specified, this INF file must also contain the section named by SectionName.

ListInfHandle [in]

Optional handle to an open INF file that contains the section specified by SectionName. Otherwise, InfHandle is assumed to contain this section.

SectionName [in]

Name of the Copy Files or Delete Files section that contains the file operations to add to the disk-space list. Use a null-terminated string.

Operation [in]

Type of file operation to be added to the list. This parameter can be one of the following values.

ValueMeaning
FILEOP_DELETE

A file delete operation.

FILEOP_COPY

A file copy operation.

 

Reserved1 [in]

Must be zero.

Reserved2 [in]

Must be zero.

Return value

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

This function requires a Windows INF file. Some older INF file formats may not be supported.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Setupapi.h

Library

Setupapi.lib

DLL

Setupapi.dll

Unicode and ANSI names

SetupAddSectionToDiskSpaceListW (Unicode) and SetupAddSectionToDiskSpaceListA (ANSI)

See also

Overview
Functions
SetupAddToDiskSpaceList
SetupAddInstallSectionToDiskSpaceList
SetupRemoveSectionFromDiskSpaceList

 

 

Community Additions

ADD
Show:
© 2014 Microsoft