Differences

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

--- en:docs:fapi:dosmkdir2 [2021/08/20 04:15] – created prokushev
+++ en:docs:fapi:dosmkdir2 [2021/09/17 06:25] (current) – prokushev
@@ Line 1: / Line 1: @@
 {{page>en:templates:fapiint}}
+====== DosMkDir2 ======
 This call creates a subdirectory that has extended attributes associated with it.
-==Syntax==
+===== Syntax =====
- DosMkDir2 (DirName, EABuf, Reserved)
+<code c>
+DosMkDir2 (DirName, EABuf, Reserved)
+</code>
+===== Parameters =====
+  * DirName ([[PSZ]]) - input : Address of the ASCIIZ directory path name, which may or may not contain 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.
+  * EABuf ([[PEAOP]]) - input/output: Address of the extended attribute buffer, which contains an [[EAOP]] structure.
+  * Reserved ([[ULONG]]) - input: Reserved and must be set to zero.
+===== Return Code =====
+rc ([[USHORT]]) - return: Return code
-==Parameters==
+  *0   NO_ERROR
-;DirName (PSZ) - input : Address of the ASCIIZ directory path name, which may or may not contain a drive specification. If no drive is specified, the current drive is assumed.
+  *3   ERROR_PATH_NOT_FOUND
-:[[DosQSysInfo]] is called by an application during initialization to determine the maximum path length allowed by OS/2.
+  *5   ERROR_ACCESS_DENIED
-;EABuf (PEAOP) - input/output: Address of the extended attribute buffer, which contains an [[EAOP]] structure.
+  *26  ERROR_NOT_DOS_DISK
-;Reserved (ULONG) - input: Reserved and must be set to zero.
+  *87  ERROR_INVALID_PARAMETER
+  *108 ERROR_DRIVE_LOCKED
+  *206 ERROR_FILENAME_EXCED_RANGE
+  *254 ERROR_INVALID_EA_NAME
+  *255 ERROR_EA_LIST_INCONSISTENT
-==Return Code==
+===== Remarks =====
-;rc (USHORT) - return:Return code descriptions are:
-*0   NO_ERROR
-*3   ERROR_PATH_NOT_FOUND
-*5   ERROR_ACCESS_DENIED
-*26  ERROR_NOT_DOS_DISK
-*87  ERROR_INVALID_PARAMETER
-*108 ERROR_DRIVE_LOCKED
-*206 ERROR_FILENAME_EXCED_RANGE
-*254 ERROR_INVALID_EA_NAME
-*255 ERROR_EA_LIST_INCONSISTENT
-==Remarks==
 DosMkDir2 allows an application to define extended attributes for a subdirectory at the time of its creation.
 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.
-==Bindings==
+===== Bindings =====
-===C===
-<PRE>
+==== C ====
+<code c>
 typedef struct _GEA {       /* gea */
   BYTE cbName;            /* name length not including NULL */
@@ Line 72: / Line 84: @@
 USHORT  rc;            /* return code */
-</PRE>
+</code>
-===MASM===
+==== MASM ====
-<PRE>
+<code asm>
 GEA    struc
   gea_cbName      db  ?          ;name length not including NULL
@@ Line 110: / Line 123: @@
 PUSH   DWORD   0             ;Reserved (must be zero)
 CALL   DosMkDir2
+</code>
 Returns WORD
-</PRE>
 {{page>en:templates:fapi}}