DosSelectDisk: Difference between revisions

Revision as of 16:01, 18 February 2017

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

This function has been renamed to "DosSetDefaultDisk".

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

Example Code

C Binding

#define INCL_DOSFILEMGR

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

MASM Binding

EXTRN  DosSelectDisk:FAR
INCL_DOSFILEMGR     EQU 1

PUSH   WORD    DriveNumber   ;Default drive number
CALL   DosSelectDisk

Returns WORD

Related Functions

@@ Line 1: / Line 1: @@
-[[image:legacy.png]]
+This call selects the drive specified as the default drive for the calling process.
-This function has been renamed to "[[OS2_API:CPI:DosSetDefaultDisk|DosSetDefaultDisk]]". [https://books.google.com.ec/books?id=u7WbsmbttwYC&pg=PT372&lpg=PT372&dq#v=onepage&q&f=false]
-==Description==
+This function has been renamed to "[[DosSetDefaultDisk]]".
-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
 Return code descriptions are:
+* 0   NO_ERROR
-* 0     NO_ERROR
+* 15  ERROR_INVALID_DRIVE
-* 15        ERROR_INVALID_DRIVE
-==Remarks==
 ==Example Code==
@@ Line 31: / Line 21: @@
 USHORT  rc = DosSelectDisk(DriveNumber);
 USHORT           DriveNumber;   /* Default drive number */
 USHORT           rc;            /* return code */
 </PRE>
@@ Line 50: / Line 38: @@
 *
+[[Category:Dos]]
-[[Category:The OS/2 API Project]]