This documentation is archived and is not being maintained.


Returns a bitmask representing the currently available disk drives.

unsigned long _getdrives( void );

If the function succeeds, the return value is a bitmask representing the currently available disk drives. Bit position 0 (the least-significant bit) is drive A, bit position 1 is drive B, bit position 2 is drive C, and so on. If the function fails, the return value is zero. To get extended error information, call GetLastError.

Routine Required header Compatibility



Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

For more compatibility information, see Compatibility in the Introduction.

// crt_getdrives.c
// This program retrives and lists out
// all the logical drives that are 
// currently mounted on the machine.

#include <windows.h>
#include <direct.h>
#include <stdio.h>
#include <tchar.h>

TCHAR g_szDrvMsg[] = _T("A:\n");

int main(int argc, char* argv[]) {
   ULONG uDriveMask = _getdrives();

   if (uDriveMask == 0)
      printf( "_getdrives() failed with failure code: %d\n",
      printf("The following logical drives are being used:\n");

      while (uDriveMask) {
         if (uDriveMask & 1)

         uDriveMask >>= 1;

Sample Output

The following logical drives are being used:

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.