Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
SetupRemoveSectionFromDiskSpaceList
Collapse the table of content
Expand the table of content

SetupRemoveSectionFromDiskSpaceList 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 SetupRemoveSectionFromDiskSpaceList function removes the file delete or copy operations listed in a Copy Files section of an INF file from a disk-space list.

Syntax


BOOL SetupRemoveSectionFromDiskSpaceList(
  _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 specified by SectionName.

ListInfHandle [in]

Optional handle to an open INF file that contains the section to remove from the disk-space list. Otherwise, InfHandle must contain the section specified by SectionName.

SectionName [in]

Pointer to a null-terminated string that specifies the name of the Copy Files or Delete Files section to remove from the disk-space list.

Operation [in]

File operation to remove from 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

The file operations removed by the SetupRemoveSectionFromDiskSpaceList function are typically those that have been added to the list by using the SetupAddSectionToDiskSpaceList function, though this is not a requirement. The SetupRemoveSectionFromDiskSpaceList function ignores files in the INF section that are not listed in the disk-space list.

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

SetupRemoveSectionFromDiskSpaceListW (Unicode) and SetupRemoveSectionFromDiskSpaceListA (ANSI)

See also

Overview
Functions
SetupRemoveFromDiskSpaceList
SetupRemoveInstallSectionFromDiskSpaceList
SetupAddSectionToDiskSpaceList

 

 

Community Additions

ADD
Show:
© 2015 Microsoft