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> | {{page> | ||
+ | |||
+ | ====== DosMkDir2 ====== | ||
This call creates a subdirectory that has extended attributes associated with it. | This call creates a subdirectory that has extended attributes associated with it. | ||
- | ==Syntax== | + | ===== Syntax ===== |
- | | + | |
+ | <code c> | ||
+ | DosMkDir2 (DirName, EABuf, Reserved) | ||
+ | </ | ||
+ | |||
+ | ===== 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/ | ||
+ | * Reserved ([[ULONG]]) - input: Reserved and must be set to zero. | ||
+ | |||
+ | ===== Return Code ===== | ||
+ | |||
+ | |||
+ | rc ([[USHORT]]) - return: Return code | ||
- | ==Parameters== | + | *0 |
- | ;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. | + | |
- | : | + | |
- | ;EABuf (PEAOP) - input/ | + | |
- | ;Reserved (ULONG) - input: Reserved and must be set to zero. | + | |
+ | *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: | + | |
- | *0 | + | |
- | *3 | + | |
- | *5 | + | |
- | *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. | 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. | 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 " | 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 " | ||
- | ==Bindings== | + | ===== Bindings ===== |
- | ===C=== | + | |
- | <PRE> | + | ==== C ==== |
+ | |||
+ | <code c> | ||
typedef struct _GEA { /* gea */ | typedef struct _GEA { /* gea */ | ||
BYTE cbName; | BYTE cbName; | ||
Line 72: | Line 84: | ||
USHORT | USHORT | ||
- | </PRE> | + | </code> |
- | ===MASM=== | + | ==== MASM ==== |
- | <PRE> | + | |
+ | <code asm> | ||
GEA struc | GEA struc | ||
gea_cbName | gea_cbName | ||
Line 110: | Line 123: | ||
PUSH | PUSH | ||
CALL | CALL | ||
+ | </ | ||
Returns WORD | Returns WORD | ||
- | </ | ||
- | |||
{{page> | {{page> |