Differences

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

--- en:docs:fapi:dosmkdir [2018/09/02 03:41] – prokushev
+++ en:docs:fapi:dosmkdir [2021/12/05 10:02] (current) – prokushev
@@ Line 1: / Line 1: @@
-{{logos:os2.gif?35x35}} {{logos:dos.gif?35x35}}
+{{page>en:templates:fapiint}}
 ====== DosMkDir ======
 This call creates a subdirectory.
-==Syntax==
+===== Syntax =====
-  DosMkDir (DirName, Reserved)
+<code c>
+DosMkDir (DirName, Reserved)
+</code>
-==Parameters==
+===== Parameters =====
-  *DirName (PSZ) - input : Address of the ASCIIZ directory path name, which may or may not include a drive specification. If no drive is specified, the current drive is assumed.
-:DosQSysInfo is called by an application during initialization to determine the maximum path length allowed by OS/2.
+  * DirName ([[PSZ]]) - input : Address of the ASCIIZ directory path name, which may or may not include a drive specification. If no drive is specified, the current drive is assumed.
-  *Reserved (ULONG) - input : Reserved and must be set to zero.
+[[DosQSysInfo]] is called by an application during initialization to determine the maximum path length allowed by OS/2.
-==Return Code==
+  *Reserved ([[ULONG]]) - input : Reserved and must be set to zero.
-  rc (USHORT) - return
+===== Return Code =====
+rc ([[USHORT]]) - return
 Return code descriptions are:
   * 0        NO_ERROR
   * 3        ERROR_PATH_NOT_FOUND
@@ Line 29: / Line 34: @@
   * 206      ERROR_FILENAME_EXCED_RANGE
-==Remarks==
+===== Remarks =====
 If any subdirectory names in the path do not exist, the subdirectory is not created. Upon return, a subdirectory is created at the end of the specified path.
-DosQSysInfo must be used by an application to determine the maximum path length supported by OS/2. The returned value should be used to dynamically allocate buffers that are to be used to store paths.
+[[DosQSysInfo]] must be used by an application to determine the maximum path length supported by OS/2. The returned value should be used to dynamically allocate buffers that are to be used to store paths.
 If a program running with the NEWFILES bit set tries to create a directory with blanks immediately preceding the dot on a FAT drive, the system rejects the name. For example, if c: is a FAT drive, the name "file .txt" is rejected and the name "file.txt" is accepted.
-==Example Code==
+===== Example Code =====
-=== C Binding===
+==== C Binding ====
+<code c>
   #define INCL_DOSFILEMGR
@@ Line 48: / Line 55: @@
   USHORT           rc;            /* return code */
+</code>
-===MASM Binding===
+==== MASM Binding ====
+<code asm>
   EXTRN  DosMkDir:FAR
   INCL_DOSFILEMGR     EQU 1
@@ Line 57: / Line 66: @@
   PUSH   DWORD   0             ;Reserved (must be zero)
   CALL   DosMkDir
+</code>
 Returns WORD
-=== Note ===
+===== Note =====
 Text based on http://www.edm2.com/index.php/DosMkDir