FSCTL_SET_ZERO_DATA (Windows CE 5.0)

Send Feedback

This IOCTL fills a specified range of a file with zeros.

Parameters

• hDevice
  [in] Handle to the file or alternate stream on which zero data is to be written. To retrieve a handle, call the CreateFile function.
• dwIoControlCode
  [in] Set to FSCTL_SET_ZERO_DATA.
• lpInBuf
  [in] Pointer to a FILE_ZERO_DATA_INFORMATION structure that specifies the range of the file to set to zeros. The FileOffset member is the byte offset of the first byte to set to zeros, and the BeyondFinalZero member is the byte offset of the first byte beyond the last zeroed byte.
• nInBufSize
  [in] Size of the input buffer, in bytes.
• lpOutBuf
  Not used. Set to NULL.
• nOutBufSize
  Not used. Set to NULL.
• lpBytesReturned
  [out] Pointer to a variable that receives the size of the data stored in the output buffer, in bytes.
• lpOverlapped
  Not used.

Return Values

If the operation succeeds, DeviceIoControl returns a nonzero value.

If the operation fails, DeviceIoControl returns zero. For extended error information, call GetLastError.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: Fsioctl.h

See Also

FSD IOCTLs | CreateFile | FILE_ZERO_DATA_INFORMATION | DeviceIoControl | GetLastError

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.