DosSelectDisk: Difference between revisions

Latest revision as of 13:11, 29 February 2020

This call selects the drive specified as the default drive for the calling process.

Syntax

DosSelectDisk (DriveNumber)

Parameters

DriveNumber (USHORT) - input: New default drive number, where 1 = A and 2 = B and so on.

Return Code

rc (USHORT) - return: Return code descriptions are:

0 NO_ERROR
15 ERROR_INVALID_DRIVE

Bindings

C

#define INCL_DOSFILEMGR

USHORT  rc = DosSelectDisk(DriveNumber);
USHORT           DriveNumber;   /* Default drive number */
USHORT           rc;            /* return code */

MASM

EXTRN  DosSelectDisk:FAR
INCL_DOSFILEMGR     EQU 1

PUSH   WORD    DriveNumber   ;Default drive number
CALL   DosSelectDisk

Returns WORD

@@ Line 1: / Line 1: @@
-==Description==
 This call selects the drive specified as the default drive for the calling process.
 ==Syntax==
-<PRE>
+  DosSelectDisk (DriveNumber)
-  DosSelectDisk
-    (DriveNumber)
-</PRE>
 ==Parameters==
-; DriveNumber (USHORT) - input : New default drive number, where 1 = A and 2 = B and so on.
+;DriveNumber (USHORT) - input : New default drive number, where 1 = A and 2 = B and so on.
 ==Return Code==
- rc (USHORT) - return
+;rc (USHORT) - return:Return code descriptions are:
+*0 NO_ERROR
+*15 ERROR_INVALID_DRIVE
-Return code descriptions are:
+==Bindings==
+===C===
-* 0     NO_ERROR
-* 15        ERROR_INVALID_DRIVE
-==Remarks==
-==Example Code==
-===C Binding===
 <PRE>
 #define INCL_DOSFILEMGR
 USHORT  rc = DosSelectDisk(DriveNumber);
 USHORT           DriveNumber;   /* Default drive number */
 USHORT           rc;            /* return code */
 </PRE>
-===MASM Binding===
+===MASM===
 <PRE>
 EXTRN  DosSelectDisk:FAR
@@ Line 44: / Line 32: @@
 Returns WORD
 </PRE>
-==Related Functions==
-*
-[[Category:The OS/2 API Project]]
+[[Category:Dos]]