en:docs:fapi:dosnewsize

This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS

Note: This is legacy API call. It is recommended to use 32-bit equivalent

2021/09/17 06:47 · prokushev
2021/08/20 05:18 · prokushev

DosNewSize

This call changes the size of a file.

Syntax

DosNewSize (FileHandle, FileSize)

Parameters

  • FileHandle (HFILE) - input : Handle of the file whose size is being changed.
  • FileSize (ULONG) - input : File's new size in bytes.

Return Code

rc (USHORT) - return

Return code descriptions are:

  • 0 NO_ERROR
  • 5 ERROR_ACCESS_DENIED
  • 6 ERROR_INVALID_HANDLE
  • 26 ERROR_NOT_DOS_DISK
  • 33 ERROR_LOCK_VIOLATION
  • 87 ERROR_INVALID_PARAMETER
  • 112 ERROR_DISK_FULL

Remarks

When DosNewSize is called, the file must be open in a mode that allows write access. If the file is a read-only file, its read-only status must be changed with DosSetFileMode before you can open the file for write access.

The open file can be truncated or extended in size. If the file is being extended, the file system makes a reasonable attempt to allocate the additional bytes for the file in a contiguous (or nearly contiguous) space on the medium. The value of the new bytes is undefined.

Example Code

C Binding

#define INCL_DOSFILEMGR
 
USHORT  rc = DosNewSize(FileHandle, FileSize);
 
HFILE            FileHandle;    /* File handle */
ULONG            FileSize;      /* File's new size */
 
USHORT           rc;            /* return code */

MASM Binding

EXTRN  DosNewSize:FAR
INCL_DOSFILEMGR     EQU 1
 
PUSH   WORD    FileHandle    ;File handle
PUSH   DWORD   FileSize      ;File's new size
CALL   DosNewSize

Returns WORD

Note


en/docs/fapi/dosnewsize.txt · Last modified: 2021/09/17 08:34 by prokushev