Funzione GetDriveTypeA (fileapi.h)

Determina se un'unità disco è un'unità disco rimovibile, fissa, CD-ROM, disco RAM o unità di rete.

Per determinare se un'unità è un'unità di tipo USB, chiamare SetupDiGetDeviceRegistryProperty e specificare la proprietà SPDRP_REMOVAL_POLICY .

Sintassi

UINT GetDriveTypeA(
  [in, optional] LPCSTR lpRootPathName
);

Parametri

[in, optional] lpRootPathName

Directory radice per l'unità.

È necessaria una barra rovesciata finale. Se questo parametro è NULL, la funzione usa la radice della directory corrente.

Valore restituito

Il valore restituito specifica il tipo di unità, che può essere uno dei valori seguenti.

Codice/valore restituito Descrizione
DRIVE_UNKNOWN
0
Impossibile determinare il tipo di unità.
DRIVE_NO_ROOT_DIR
1
Il percorso radice non è valido; ad esempio, non è presente alcun volume montato nel percorso specificato.
DRIVE_REMOVABLE
2
L'unità ha supporti rimovibili; ad esempio un'unità floppy, un'unità personale o un lettore di schede flash.
DRIVE_FIXED
3
L'unità ha supporti fissi; ad esempio, un disco rigido o un'unità flash.
DRIVE_REMOTE
4
L'unità è un'unità remota (rete).
DRIVE_CDROM
5
L'unità è un'unità CD-ROM.
DRIVE_RAMDISK
6
L'unità è un disco RAM.

Commenti

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 No
Failover trasparente SMB 3.0 (TFO) No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) No
File system del volume condiviso del cluster (CsvFS)
File system resiliente (ReFS)
 

SMB non supporta le funzioni di gestione dei volumi.

Nota

L'intestazione fileapi.h definisce GetDriveType come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione fileapi.h (includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

GetDiskFreeSpace

Funzioni di gestione dei volumi