SetupCreateDiskSpaceList

[New for Windows NT 4.0 Service Pack 3.]

The SetupCreateDiskSpaceList function creates a disk-space list.

HDSKSPC SetupCreateDiskSpaceList(
  PVOID Reserved1,  // unused, must be zero
  DWORD Reserved2,  // unused, must be zero
  UINT Flags        // specifies whether to ignore files already on 
                    // the disk
);
 

Parameters

Reserved1

Unused, must be 0.

Reserved2

Unused, must be 0.

Flags

You can set the following flag:

SPDSL_IGNORE_DISK

Specifies that file operations added to the list will ignore files that already exist on the disk. For example, if the disk contains a 5000 byte file, C:\MyDir\MyFile, and you add a copy operation to the disk-space list for a new version, C:\MyDir\MyFile, that is 6500 bytes, the space required will be 6500 bytes (instead of 1500 bytes, which is the value returned if you do not set SPDSL_IGNORE_DISK).

Return Values

If the function succeeds, it returns a handle to the disk-space list.

If the function fails, it returns NULL. 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, SetupDestroyDiskSpaceList