Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | |||
en:docs:fapi:dosmove [2021/08/20 04:16] – prokushev | en:docs:fapi:dosmove [2021/09/17 06:31] (current) – prokushev | ||
---|---|---|---|
Line 5: | Line 5: | ||
This call moves a file object to another location and changes its name. | This call moves a file object to another location and changes its name. | ||
- | ==Syntax== | + | ===== Syntax ===== |
- | | + | |
- | ==Parameters== | + | <code c> |
- | ;OldPathName (PSZ) - input : Address of the old path name of the file to be moved. | + | DosMove (OldPathName, |
- | ;NewPathName (PSZ) - input : Address of the new path name of the file. | + | </ |
- | ;Reserved (ULONG) - input : Reserved and must be set to zero. | + | |
+ | ===== Parameters ===== | ||
+ | |||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | ===== Return Code ===== | ||
+ | |||
+ | rc ([[USHORT]]) - return | ||
- | ==Return Code== | ||
- | rc (USHORT) - return | ||
Return code descriptions are: | Return code descriptions are: | ||
- | *0 | ||
- | * 2 | ||
- | * 3 | ||
- | * 5 | ||
- | * 17 | ||
- | * 26 | ||
- | * 32 | ||
- | * 36 | ||
- | * 87 | ||
- | * 108 | ||
- | * 206 | ||
- | * 250 | ||
- | * 251 | ||
- | ==Remarks== | + | * 0 |
+ | * 2 | ||
+ | * 3 | ||
+ | * 5 | ||
+ | * 17 | ||
+ | * 26 | ||
+ | * 32 | ||
+ | * 36 | ||
+ | * 87 | ||
+ | * 108 | ||
+ | * 206 | ||
+ | * 250 | ||
+ | * 251 | ||
+ | |||
+ | ===== Remarks ===== | ||
This call is often used to change only the name of a file or subdirectory, | This call is often used to change only the name of a file or subdirectory, | ||
Line 39: | Line 47: | ||
Attributes (times and dates) of the source file object are moved to the target. If read-only files exist in the target path, they are not replaced. | Attributes (times and dates) of the source file object are moved to the target. If read-only files exist in the target path, they are not replaced. | ||
- | DosQSysInfo is called during initialization by an application to determine the maximum path length allowed by OS/2. | + | [[DosQSysInfo]] is called during initialization by an application to determine the maximum path length allowed by OS/2. |
DosMove can be used to change the case of a file on an FSD drive. The following example would change the name of the file to " | DosMove can be used to change the case of a file on an FSD drive. The following example would change the name of the file to " | ||
| | ||
- | ===Family API Considerations=== | + | ==== Family API Considerations ==== |
Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following restriction applies to DosMove when coding for the DOS mode: | Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following restriction applies to DosMove when coding for the DOS mode: | ||
File names passed to OldPathName and NewPathName are truncated by the system in the DOS mode only. The application must truncate all files passed to OldPathName and NewPathName in the OS/2 mode or an error code is returned. | File names passed to OldPathName and NewPathName are truncated by the system in the DOS mode only. The application must truncate all files passed to OldPathName and NewPathName in the OS/2 mode or an error code is returned. | ||
- | ==Example Code== | + | ===== Example Code ===== |
- | ===C Binding=== | + | |
- | <PRE> | + | ==== C Binding ==== |
+ | |||
+ | <code c> | ||
#define INCL_DOSFILEMGR | #define INCL_DOSFILEMGR | ||
Line 61: | Line 72: | ||
USHORT | USHORT | ||
- | </PRE> | + | </code> |
- | ===MASM Binding=== | + | ==== MASM Binding ==== |
- | <PRE> | + | |
+ | <code asm> | ||
EXTRN DosMove:FAR | EXTRN DosMove:FAR | ||
INCL_DOSFILEMGR | INCL_DOSFILEMGR | ||
Line 72: | Line 84: | ||
PUSH | PUSH | ||
CALL | CALL | ||
+ | </ | ||
Returns WORD | Returns WORD | ||
- | </ | ||
- | === Note === | + | |
+ | ===== Note ===== | ||
Text based on [[http:// | Text based on [[http:// | ||
{{page> | {{page> |