en:docs:fapi:dosmkdir

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
en:docs:fapi:dosmkdir [2018/08/28 04:11]
prokushev
en:docs:fapi:dosmkdir [2018/09/02 05:41] (current)
prokushev
Line 5: Line 5:
  
 ==Syntax== ==Syntax==
- ​DosMkDir (DirName, Reserved)+ 
 +  ​DosMkDir (DirName, Reserved)
  
 ==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.+ 
 +  *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. :​DosQSysInfo is called by an application during initialization to determine the maximum path length allowed by OS/2.
-Reserved (ULONG) - input : Reserved and must be set to zero.+ 
 +  *Reserved (ULONG) - input : Reserved and must be set to zero.
  
 ==Return Code== ==Return Code==
- rc (USHORT) - return+ 
 +  rc (USHORT) - return 
 Return code descriptions are: Return code descriptions are:
-* 0        NO_ERROR  +  ​* 0        NO_ERROR  
-* 3        ERROR_PATH_NOT_FOUND  +  * 3        ERROR_PATH_NOT_FOUND  
-* 5        ERROR_ACCESS_DENIED  +  * 5        ERROR_ACCESS_DENIED  
-* 26       ​ERROR_NOT_DOS_DISK  +  * 26       ​ERROR_NOT_DOS_DISK  
-* 87       ​ERROR_INVALID_PARAMETER  +  * 87       ​ERROR_INVALID_PARAMETER  
-* 108      ERROR_DRIVE_LOCKED  +  * 108      ERROR_DRIVE_LOCKED  
-* 206      ERROR_FILENAME_EXCED_RANGE+  * 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. 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.
  
Line 32: Line 39:
 ==Example Code== ==Example Code==
 === C Binding=== === C Binding===
-<PRE> 
-#define INCL_DOSFILEMGR 
- 
-USHORT ​ rc = DosMkDir(DirName,​ Reserved); 
- 
-PSZ              DirName; ​      /* New directory string name */ 
-ULONG            0;             /* Reserved (must be zero) */ 
  
-USHORT ​          ​rc; ​           /* return code */ +  #define INCL_DOSFILEMGR 
-</​PRE>​+   
 +  USHORT ​ rc = DosMkDir(DirName,​ Reserved);​ 
 +   
 +  PSZ              DirName; ​      /* New directory string name */ 
 +  ULONG            0;             /* Reserved (must be zero) */ 
 +   
 +  ​USHORT ​          ​rc; ​           /* return code */
  
 ===MASM Binding=== ===MASM Binding===
-<PRE> 
-EXTRN  DosMkDir:​FAR 
-INCL_DOSFILEMGR ​    EQU 1 
  
-PUSH@  ASCIIZ ​ DirName ​      ;New directory name string +  EXTRN  DosMkDir:​FAR 
-PUSH   ​DWORD ​  ​0 ​            ;​Reserved (must be zero) +  INCL_DOSFILEMGR ​    EQU 1 
-CALL   ​DosMkDir+   
 +  ​PUSH@  ASCIIZ ​ DirName ​      ;New directory name string 
 +  PUSH   ​DWORD ​  ​0 ​            ;​Reserved (must be zero) 
 +  CALL   ​DosMkDir
  
 Returns WORD Returns WORD
-</​PRE>​ 
  
 === Note === === Note ===

en/docs/fapi/dosmkdir.txt · Last modified: 2018/09/02 05:41 by prokushev