Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionNext revisionBoth sides next revision | ||
en:docs:fapi:dosmkdir [2018/08/28 02:10] – created prokushev | en:docs:fapi:dosmkdir [2018/09/02 03:41] – prokushev | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{logos: | ||
+ | ====== DosMkDir ====== | ||
This call creates a subdirectory. | This call creates a subdirectory. | ||
==Syntax== | ==Syntax== | ||
- | | + | |
+ | | ||
==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. | ||
: | : | ||
- | ; 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 | + | |
- | * 3 ERROR_PATH_NOT_FOUND | + | * 3 ERROR_PATH_NOT_FOUND |
- | * 5 ERROR_ACCESS_DENIED | + | * 5 ERROR_ACCESS_DENIED |
- | * 26 | + | * 26 |
- | * 87 | + | * 87 |
- | * 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 30: | Line 39: | ||
==Example Code== | ==Example Code== | ||
=== C Binding=== | === C Binding=== | ||
- | <PRE> | ||
- | #define INCL_DOSFILEMGR | ||
- | |||
- | USHORT | ||
- | |||
- | PSZ DirName; | ||
- | ULONG 0; /* Reserved (must be zero) */ | ||
- | USHORT | + | #define INCL_DOSFILEMGR |
- | </ | + | |
+ | USHORT | ||
+ | |||
+ | PSZ DirName; | ||
+ | ULONG 0; /* Reserved (must be zero) */ | ||
+ | |||
+ | | ||
===MASM Binding=== | ===MASM Binding=== | ||
- | <PRE> | ||
- | EXTRN DosMkDir: | ||
- | INCL_DOSFILEMGR | ||
- | PUSH@ ASCIIZ | + | EXTRN DosMkDir: |
- | PUSH | + | INCL_DOSFILEMGR |
- | CALL | + | |
+ | | ||
+ | PUSH | ||
+ | CALL | ||
Returns WORD | Returns WORD | ||
- | </ | ||
=== Note === | === Note === |