`_getdrives`

Articolo
10/12/2023

Restituisce una maschera di bit che rappresenta le unità disco attualmente disponibili.

Importante

Non è possibile usare questa API nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

unsigned long _getdrives( void );

Valore restituito

Se la funzione viene completata con successo, il valore restituito è una maschera di bit che rappresenta le unità disco attualmente disponibili. La posizione di bit 0 (bit meno significativo) rappresenta l'unità A. Analogamente, la posizione del bit 1 rappresenta l'unità B, la posizione del bit 2 rappresenta l'unità C e così via. Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni:

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo	Intestazione obbligatoria
`_getdrives`	<direct.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// crt_getdrives.c
// This program retrieves 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",
              GetLastError());
   }
   else
   {
      printf("The following logical drives are being used:\n");

      while (uDriveMask) {
         if (uDriveMask & 1)
            printf(g_szDrvMsg);

         ++g_szDrvMsg[0];
         uDriveMask >>= 1;
      }
   }
}

The following logical drives are being used:
A:
C:
D:
E:

Vedi anche

Controllo directory

Condividi tramite