Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionLast revisionBoth sides next revision | ||
en:docs:fapi:dosqcurdir [2018/08/28 08:56] – created prokushev | en:docs:fapi:dosqcurdir [2021/09/17 06:41] – prokushev | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{page> | ||
+ | |||
+ | ====== DosQCurDir ====== | ||
+ | |||
This call returns the full path name of the current directory for the requesting process for the specified drive. | This call returns the full path name of the current directory for the requesting process for the specified drive. | ||
- | ==Syntax== | + | ===== Syntax ===== |
- | | + | |
- | ==Parameters== | + | <code c> |
- | ;DriveNumber (USHORT) - input : Drive number, for example: | + | DosQCurDir (DriveNumber, |
- | | + | </ |
- | Definition | + | |
- | default | + | ===== Parameters ===== |
- | | + | |
- | B ... | + | |
- | ;DirPath (PBYTE) - output : Address of the fully qualified path name of current directory. | + | |
- | ;DirPathLen (PUSHORT) - input/ | + | |
+ | 0 | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | * DirPath ([[PBYTE]]) - output : Address of the fully qualified path name of current directory. | ||
+ | | ||
+ | |||
+ | ===== Return Code ===== | ||
+ | |||
+ | rc ([[USHORT]]) - return | ||
- | ==Return Code== | ||
- | rc (USHORT) - return | ||
Return code descriptions are: | Return code descriptions are: | ||
- | * 0 | ||
- | * 15 ERROR_INVALID_DRIVE | ||
- | * 26 ERROR_NOT_DOS_DISK | ||
- | * 108 ERROR_DRIVE_LOCKED | ||
- | * 111 ERROR_BUFFER_OVERFLOW | ||
- | ==Remarks== | + | * 0 |
+ | * 15 ERROR_INVALID_DRIVE | ||
+ | * 26 ERROR_NOT_DOS_DISK | ||
+ | * 108 ERROR_DRIVE_LOCKED | ||
+ | * 111 ERROR_BUFFER_OVERFLOW | ||
+ | |||
+ | ===== Remarks ===== | ||
The drive letter is not part of the returned string. The string does not begin with a backslash and is terminated by a byte containing 00H. | The drive letter is not part of the returned string. The string does not begin with a backslash and is terminated by a byte containing 00H. | ||
Line 34: | Line 48: | ||
[[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. | ||
- | ==Bindings== | + | ===== Bindings ===== |
- | ===C Binding=== | + | |
- | <PRE> | + | ==== C Binding ==== |
+ | |||
+ | <code c> | ||
#define INCL_DOSFILEMGR | #define INCL_DOSFILEMGR | ||
Line 46: | Line 62: | ||
USHORT | USHORT | ||
- | </PRE> | + | </code> |
+ | |||
+ | ==== MASM Binding ==== | ||
- | ===MASM Binding=== | + | <code asm> |
- | <PRE> | + | |
EXTRN DosQCurDir: | EXTRN DosQCurDir: | ||
INCL_DOSFILEMGR | INCL_DOSFILEMGR | ||
Line 58: | Line 75: | ||
CALL | CALL | ||
+ | </ | ||
Returns WORD | Returns WORD | ||
- | === Note === | + | ===== Note ===== |
Text based on http:// | Text based on http:// |