SetupRemoveFromDiskSpaceList

[New for Windows NT 4.0 Service Pack 3.]

The SetupRemoveFromDiskSpaceList function removes a file delete or copy operation from a disk-space list.

BOOL SetupRemoveFromDiskSpaceList(
  HDSKSPC DiskSpace,      // handle to the disk-space list
  PCTSTR TargetFilespec,  // specifies the path and filename
  UINT Operation,         // specifies the type of file operation
  PVOID Reserved1,        // must be zero
  UINT Reserved2          // must be zero
);
 

Parameters

DiskSpace

Supplies a handle to a disk-space list.

TargetFilespec

Specifies the filename of the file to remove from the disk-space list. This is typically a fully specified Win32 path. Otherwise, the path must be relative to the current directory.

Operation

Specifies the file operation to remove from the list. This parameter can be one of the following values.

Value	Meaning
FILEOP_DELETE	A file delete operation.
FILEOP_COPY	A file copy operation.

Reserved1

Must be 0.

Reserved2

Must be 0.

Return Values

If the file was not in the list, the SetupRemoveFromDiskSpaceList function returns a non-zero value and GetLastError returns ERROR_INVALID_DRIVE or ERROR_INVALID_NAME. If the file was in the list then upon success the routine returns a non-zero value and GetLastError returns NO_ERROR.

If the routine fails for some other reason, it returns zero and GetLastError returns extended error information.

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, SetupRemoveSectionFromDiskSpaceList, SetupRemoveInstallSectionFromDiskSpaceList, SetupAddToDiskSpaceList