The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at _getdrives.

Returns a bitmask that represents the currently available disk drives.

System_CAPS_ICON_important.jpg Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW.

unsigned long _getdrives( void );  

If the function succeeds, the return value is a bitmask that represents 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.

RoutineRequired header

For more compatibility information, see Compatibility.

      // 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;  

The following logical drives are being used:  

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

Directory Control