en:docs:fapi:dosqcurdir

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
en:docs:fapi:dosqcurdir [2021/09/12 03:22] – prokusheven:docs:fapi:dosqcurdir [2021/12/05 10:59] (current) – prokushev
Line 5: Line 5:
 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 =====
  
 <code c> <code c>
Line 11: Line 11:
 </code> </code>
  
-==Parameters==+===== Parameters =====
  
-  * DriveNumber (USHORT) - input : Drive number, for example: +  * DriveNumber ([[USHORT]]) - input : Drive number, for example: 
- Value + 
-     Definition 0 +  Value Definition 
-     default 1 +  0     default 
-     A 2 +  1     A  
-     B ... +  2     B 
-  * DirPath (PBYTE) - output : Address of the fully qualified path name of current directory. +  ... 
-  * DirPathLen (PUSHORT) - input/output : Address of the length of the DirPath buffer. On input, this field contains the length of the directory path buffer in bytes. On output, if an error is returned because the buffer is too small, this field contains the required length.+ 
 +  * DirPath ([[PBYTE]]) - output : Address of the fully qualified path name of current directory. 
 +  * DirPathLen ([[PUSHORT]]) - input/output : Address of the length of the DirPath buffer. On input, this field contains the length of the directory path buffer in bytes. On output, if an error is returned because the buffer is too small, this field contains the required length. 
 + 
 +===== Return Code ===== 
 + 
 +rc ([[USHORT]]) - return
  
-==Return Code== 
- rc (USHORT) - return 
 Return code descriptions are: Return code descriptions are:
  
Line 32: Line 36:
   * 111 ERROR_BUFFER_OVERFLOW   * 111 ERROR_BUFFER_OVERFLOW
  
-==Remarks==+===== 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 39: Line 44:
 For FSDs, the case of the current directory is set according to the DirName passed in, not according to the case of the directories on disk. For example, if the directory "c:\bin" is created and [[DosChDir]] is called with DirName "c:\bin", the current directory returned by DosQCurDir will be "c:\bin". For FSDs, the case of the current directory is set according to the DirName passed in, not according to the case of the directories on disk. For example, if the directory "c:\bin" is created and [[DosChDir]] is called with DirName "c:\bin", the current directory returned by DosQCurDir will be "c:\bin".
  
-Programs running without the NEWFILES bit set are allowed to DosChDir to a non-8.3 filename format directory.+Programs running without the NEWFILES bit set are allowed to [[DosChDir]] to a non-8.3 filename format directory.
  
 [[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===+ 
 +==== C Binding ==== 
 <code c> <code c>
 #define INCL_DOSFILEMGR #define INCL_DOSFILEMGR
Line 57: Line 64:
 </code> </code>
  
-===MASM Binding===+==== MASM Binding ==== 
 <code asm> <code asm>
 EXTRN  DosQCurDir:FAR EXTRN  DosQCurDir:FAR
Line 67: Line 75:
 CALL   DosQCurDir CALL   DosQCurDir
  
-Returns WORD 
 </code> </code>
 +Returns WORD
  
-=== Note ===+===== Note =====
  
 Text based on http://www.edm2.com/index.php/DosQCurDir Text based on http://www.edm2.com/index.php/DosQCurDir