DosQCurDisk: Difference between revisions

Latest revision as of 06:04, 26 January 2020

This call determines the current default drive for the requesting process.

Syntax

DosQCurDisk (DriveNumber, LogicalDriveMap)

Parameters

DriveNumber (PUSHORT) - output

Address of the number of the default drive, for example:

1 A

2 B ...

LogicalDriveMap (PULONG) - output

Address of the bit map (stored in the low-order portion of the 32-bit, doubleword area) where the system returns the mapping of the logical drives. Logical Drives A to Z have a one-to-one mapping with the bit positions 0 to 25 of the map; for example, bit 0 is drive A, bit 1 is drive B, and so forth. The settings of these bits indicate which drives exist:

0 - The logical drive does not exist.

1 - The logical drive exists.

Return Code

rc (USHORT) - return: Return code description is:

0 NO_ERROR

Bindings

C

#define INCL_DOSFILEMGR

USHORT  rc = DosQCurDisk(DriveNumber, LogicalDriveMap);
PUSHORT DriveNumber;     /* Default drive number (returned) */
PULONG  LogicalDriveMap; /* Drive map area (returned) */

USHORT  rc;              /* return code */

MASM

EXTRN  DosQCurDisk:FAR
INCL_DOSFILEMGR     EQU 1

PUSH@  WORD    DriveNumber     ;Default drive number (returned)
PUSH@  DWORD   LogicalDriveMap ;Drive map area (returned)
CALL   DosQCurDisk

Returns WORD

@@ Line 1: / Line 1: @@
-[[image:legacy.png]]
+This call determines the current default drive for the requesting process.
-This function has been renamed to "[[OS2_API:CPI:DosQueryCurrentDisk|DosQueryCurrentDisk]]". [https://books.google.com.ec/books?id=u7WbsmbttwYC&pg=PT372&lpg=PT372&dq#v=onepage&q&f=false]
-==Description==
-This call determines the current default drive for the requesting process.
 ==Syntax==
-<PRE>
+  DosQCurDisk (DriveNumber, LogicalDriveMap)
-  DosQCurDisk
-    (DriveNumber, LogicalDriveMap)
-</PRE>
 ==Parameters==
-;  DriveNumber (PUSHORT) - output : Address of the number of the default drive, for example:
+;DriveNumber (PUSHORT) - output : Address of the number of the default drive, for example:
+::1  A
- '''Value        Definition'''
+::2  B ...
-        A
+;LogicalDriveMap (PULONG) - output : Address of the bit map (stored in the low-order portion of the 32-bit, doubleword area) where the system returns the mapping of the logical drives. Logical Drives A to Z have a one-to-one mapping with the bit positions 0 to 25 of the map; for example, bit 0 is drive A, bit 1 is drive B, and so forth. The settings of these bits indicate which drives exist:
-        B
+::0 - The logical drive does not exist.
- .        .
+::1 - The logical drive exists.
-    .
-; LogicalDriveMap (PULONG) - output : Address of the bit map (stored in the low-order portion of the 32-bit, doubleword area) where the system returns the mapping of the logical drives. Logical Drives A to Z have a one-to-one mapping with the bit positions 0 to 25 of the map; for example, bit 0 is drive A, bit 1 is drive B, and so forth. The settings of these bits indicate which drives exist:
- '''Value            Definition'''
-           The logical drive does not exist.
-           The logical drive exists.
 ==Return Code==
-rc (USHORT) - return
+;rc (USHORT) - return:Return code description is:
+* 0 NO_ERROR
-Return code description is:
+==Bindings==
+===C===
-* 0    NO_ERROR
-==Remarks==
-==Example Code==
-=== C Binding===
 <PRE>
 #define INCL_DOSFILEMGR
 USHORT  rc = DosQCurDisk(DriveNumber, LogicalDriveMap);
+PUSHORT DriveNumber;     /* Default drive number (returned) */
+PULONG  LogicalDriveMap; /* Drive map area (returned) */
-PUSHORT          DriveNumber;     /* Default drive number (returned) */
+USHORT  rc;              /* return code */
-PULONG           LogicalDriveMap; /* Drive map area (returned) */
-USHORT           rc;              /* return code */
 </PRE>
-===MASM Binding===
+===MASM===
 <PRE>
 EXTRN  DosQCurDisk:FAR
@@ Line 61: / Line 40: @@
 </PRE>
-==Related Functions==
+[[Category:Dos16]]
-*
-[[Category:The OS/2 API Project]]