Função GetDriveTypeA (fileapi.h)
Determina se uma unidade de disco é removível, fixa, CD-ROM, disco de RAM ou unidade de rede.
Para determinar se uma unidade é uma unidade do 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 de retorno
O valor retornado especifica o tipo de unidade, que pode ser um dos valores a seguir.
| Código/valor de retorno | 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, uma 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 de RAM. |
Observações
No Windows 8 e no Windows Server 2012, essa função é compatível com as tecnologias a seguir.
| Tecnologia | Suportado |
|---|---|
| Protocolo SMB (Bloco de Mensagens do Servidor) 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 de Cluster (CsvFS) | Sim |
| ReFS (Sistema de Arquivos Resiliente) | Sim |
O SMB não dá suporte a funções de gerenciamento de volume.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino |
Windows |
| cabeçalho | fileapi.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |