Syntax

  #include <nwdfs.h>  
   
  LONG DFSSetEndOfFile  (  
     LONG   fileHandle,   
     LONG   newFileSize,   
     LONG   returnTruncatedBlocksFlag); 
  

Parameters

fileHandle

(IN) Specifies the file handle returned from a prior DFSsopen or DFScreat call for the indicated file.

newFileSize

(IN) Specifies the new file size in bytes.

returnTruncatedBlocksFlag

(IN) Specifies a nonzero value specified here indicates that any blocks truncated by the new file size should be freed up for future OS use.

Return Values

Remarks

If the connection making the request is the only entity with the file open and if the returnTruncatedBlocksFlag is nonzero, setting a new file size that is one or more blocks less than the previous file size causes blocks (actually allocated) beyond the new defined file size to be truncated, or returned for future OS usage. If a new file size is specified that is greater than the previous file size, the newly defined file area is zero-filled, provided that actual file space is allocated. A new file size can be specified that is beyond the range of current allocated file space, or that is less than current allocated file space.

See Also

DFSExpandFile, DFSReturnFileMappingInformation, DFSWrite