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 |
|---|---|
|
O tipo de unidade não pode ser determinado. |
|
O caminho raiz é inválido; por exemplo, não há nenhum volume montado no caminho especificado. |
|
A unidade tem mídia removível; por exemplo, uma unidade disquete, um pen drive ou um leitor de cartão flash. |
|
A unidade tem mídia fixa; por exemplo, uma unidade de disco rígido ou uma unidade flash. |
|
A unidade é uma unidade remota (rede). |
|
A unidade é uma unidade CD-ROM. |
|
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 |