Compartilhar via


Função GetLogicalDrives (fileapi.h)

Recupera uma máscara de bits que representa as unidades de disco disponíveis no momento.

Sintaxe

DWORD GetLogicalDrives();

Valor de retorno

Se a função for bem-sucedida, o valor retornado será uma máscara de bits que representa as unidades de disco disponíveis no momento. A posição do bit 0 (o bit menos significativo) é a unidade A, a posição de bit 1 é a unidade B, a posição do bit 2 é a unidade C e assim por diante.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Observe que, nesse contexto, "disponível" significa que a letra da unidade está atribuída atualmente a uma unidade lógica existente (por exemplo, um volume local, mídia removível ou um compartilhamento de rede mapeado). Os bits limpos indicam letras de unidade que não estão atribuídas no momento e, portanto, podem ser usadas para pontos de montagem futuros.

A partir do Windows 8 e do Windows Server 2012, essa função é compatível com as seguintes tecnologias:

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) Yes
ReFS (Sistema de Arquivos Resiliente) Yes

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

Requirements

Requirement Value
Cliente mínimo suportado Windows XP [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header fileapi.h (inclua Windows.h)
Library Kernel32.lib
de DLL Kernel32.dll

Consulte também

GetLogicalDriveStrings

Funções de gerenciamento de volume