Funzione GetDriveTypeA (fileapi.h)

Articolo
11/20/2024

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

Per determinare se 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à dispone di supporti rimovibili; ad esempio un'unità floppy, un'unità thumb o un lettore di schede flash.
DRIVE_FIXED 3	L'unità ha supporti fissi; ad esempio un'unità disco rigido o un'unità flash.
DRIVE_REMOTE 4	L'unità è un'unità remota (di rete).
DRIVE_CDROM 5	L'unità è un'unità CD-ROM.
DRIVE_RAMDISK 6	L'unità è un disco RAM.

Osservazioni

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

Tecnologia	Sostenuto
Protocollo SMB (Server Message Block) 3.0	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	No
Cluster Shared Volume File System (CsvFS)	Sì
Resilient File System (ReFS)	Sì

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	fileapi.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

GetDiskFreeSpace

funzioni di gestione dei volumi

Condividi tramite