Função GetDriveTypeA (fileapi.h)

Determina se uma unidade de disco é removível, fixa, CD-ROM, disco RAM ou unidade de rede.

Para determinar se uma unidade é de tipo USB, chame SetupDiGetDeviceRegistryProperty e especifique a propriedade SPDRP_REMOVAL_POLICY .

Sintaxe

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

Parâmetros

[in, optional] lpRootPathName

O diretório raiz da unidade.

Uma barra invertida à direita é necessária. Se esse parâmetro for NULL, a função usará a raiz do diretório atual.

Valor retornado

O valor retornado especifica o tipo de unidade, que pode ser um dos valores a seguir.

Valor/código retornado Descrição
DRIVE_UNKNOWN
0
O tipo de unidade não pode ser determinado.
DRIVE_NO_ROOT_DIR
1
O caminho raiz é inválido; por exemplo, não há nenhum volume montado no caminho especificado.
DRIVE_REMOVABLE
2
A unidade tem mídia removível; por exemplo, uma unidade disquete, um pen drive ou um leitor de cartão flash.
DRIVE_FIXED
3
A unidade tem mídia fixa; por exemplo, uma unidade de disco rígido ou uma unidade flash.
DRIVE_REMOTE
4
A unidade é uma unidade remota (rede).
DRIVE_CDROM
5
A unidade é uma unidade CD-ROM.
DRIVE_RAMDISK
6
A unidade é um disco RAM.

Comentários

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 Não
TFO (Failover transparente) do SMB 3.0 Não
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) Não
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim
 

O SMB não dá suporte a funções de gerenciamento de volume.

Observação

O cabeçalho fileapi.h define GetDriveType como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho fileapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

GetDiskFreeSpace

Funções de gerenciamento de volumes