Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionNext revisionBoth sides next revision | ||
en:docs:fapi:doschdir [2018/08/26 13:28] – created prokushev | en:docs:fapi:doschdir [2020/12/07 01:52] – prokushev | ||
---|---|---|---|
Line 5: | Line 5: | ||
==Syntax== | ==Syntax== | ||
- | | + | |
+ | | ||
==Parameters== | ==Parameters== | ||
- | ;DirName (PSZ) - input : Address of the ASCIIZ directory path name. | + | |
- | ;Reserved (ULONG) - input : Reserved and must be set to zero. | + | *DirName ([[PSZ]]) - input : Address of the ASCIIZ directory path name. |
+ | *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 | + | |
- | * 2 ERROR_FILE_NOT_FOUND | + | * 2 ERROR_FILE_NOT_FOUND |
- | * 3 ERROR_PATH_NOT_FOUND | + | * 3 ERROR_PATH_NOT_FOUND |
- | * 5 ERROR_ACCESS_DENIED | + | * 5 ERROR_ACCESS_DENIED |
- | * 8 ERROR_NOT_ENOUGH_MEMORY | + | * 8 ERROR_NOT_ENOUGH_MEMORY |
- | * 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== | ||
+ | |||
The directory path is not changed if any member of the path does not exist. The current directory changes only for the requesting process. | The directory path is not changed if any member of the path does not exist. The current directory changes only for the requesting process. | ||
Line 35: | Line 40: | ||
==Example Code== | ==Example Code== | ||
===C Binding=== | ===C Binding=== | ||
- | <PRE> | + | <code c> |
#define INCL_DOSFILEMGR | #define INCL_DOSFILEMGR | ||
USHORT | USHORT | ||
- | PSZ DirName; | + | PSZ DirName; |
ULONG 0; /* Reserved (must be zero) */ | ULONG 0; /* Reserved (must be zero) */ | ||
USHORT | USHORT | ||
- | </PRE> | + | </code> |
This example changes directories to \os2\system. | This example changes directories to \os2\system. | ||
- | <PRE> | + | <code c> |
#define INCL_DOSFILEMGR | #define INCL_DOSFILEMGR | ||
Line 55: | Line 59: | ||
USHORT rc; | USHORT rc; | ||
- | rc = DosChDir(PATH, | + | rc = DosChDir(PATH, |
- | </PRE> | + | |
+ | </code> | ||
===MASM Binding=== | ===MASM Binding=== | ||
- | <PRE> | + | <code asm> |
EXTRN DosChDir: | EXTRN DosChDir: | ||
INCL_DOSFILEMGR | INCL_DOSFILEMGR | ||
+ | | ||
PUSH@ ASCIIZ | PUSH@ ASCIIZ | ||
PUSH | PUSH | ||
CALL | CALL | ||
+ | </ | ||
Returns WORD | Returns WORD | ||
- | </ | ||
=== Note === | === Note === |