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/09/17 06:34] – 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
+  * 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