Differences

This shows you the differences between two versions of the page.

--- en:docs:fapi:dosnewsize [2018/08/30 16:15] – created prokushev
+++ en:docs:fapi:dosnewsize [2021/12/05 10:58] (current) – prokushev
@@ Line 1: / Line 1: @@
+{{page>en:templates:fapiint}}
+====== DosNewSize ======
 This call changes the size of a file.
-==Syntax==
+===== Syntax =====
- DosNewSize (FileHandle, FileSize)
+<code c>
+DosNewSize (FileHandle, FileSize)
+</code>
-==Parameters==
+===== Parameters =====
-;FileHandle (HFILE) - input : Handle of the file whose size is being changed.
-;FileSize (ULONG) - input : File's new size in bytes.
+  * 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==
- 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==
+  * 0        NO_ERROR
-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.
+  * 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==
+===== Example Code =====
-=== C Binding===
-<PRE>
+==== C Binding====
+<code c>
 #define INCL_DOSFILEMGR
@@ Line 36: / Line 47: @@
 USHORT           rc;            /* return code */
-</PRE>
+</code>
-===MASM Binding===
+==== MASM Binding ====
-<PRE>
+<code asm>
 EXTRN  DosNewSize:FAR
 INCL_DOSFILEMGR     EQU 1
@@ Line 46: / Line 57: @@
 PUSH   DWORD   FileSize      ;File's new size
 CALL   DosNewSize
+</code>
 Returns WORD
-</PRE>
-====== Note ======
+===== Note =====
 Text based on http://www.edm2.com/index.php/DosNewSize