Export (0) Print
Expand All
Expand Minimize

SetupCreateDiskSpaceList 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 SetupCreateDiskSpaceList function creates a disk-space list.

Syntax


HDSKSPC SetupCreateDiskSpaceList(
  _In_  PVOID Reserved1,
  _In_  DWORD Reserved2,
  _In_  UINT Flags
);

Parameters

Reserved1 [in]

Unused, must be zero.

Reserved2 [in]

Unused, must be zero.

Flags [in]

This parameter can be the following value.

SPDSL_IGNORE_DISK

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 value

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.

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

SetupCreateDiskSpaceListW (Unicode) and SetupCreateDiskSpaceListA (ANSI)

See also

Overview
Functions
SetupDestroyDiskSpaceList

 

 

Community Additions

ADD
Show:
© 2015 Microsoft