Edit

FILE_SET_SPARSE_BUFFER structure (winioctl.h)

  • Article

Specifies the sparse state to be set.Windows Server 2003 and Windows XP:  This structure is optional. For more information, see FSCTL_SET_SPARSE.

Syntax

typedef struct _FILE_SET_SPARSE_BUFFER {
  BOOLEAN SetSparse;
} FILE_SET_SPARSE_BUFFER, *PFILE_SET_SPARSE_BUFFER;

Members

SetSparse

If TRUE, makes the file sparse.

If FALSE, makes the file not sparse.

Windows Server 2008 R2, Windows 7, Windows Server 2008 and Windows Vista:  A value of FALSE for this member is valid only on files that no longer have any sparse regions. For more information, see FSCTL_SET_SPARSE.

Windows Server 2003 and Windows XP:  A value of FALSE for this member is not supported. Specifying FALSE will cause the FSCTL_SET_SPARSE call to fail.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header winioctl.h (include Windows.h)

See also

DeviceIoControl

FSCTL_SET_SPARSE