Função GetLogicalDriveStringsA (winbase.h)
Preenche um buffer com cadeias de caracteres que especificam unidades válidas no sistema.
Sintaxe
DWORD GetLogicalDriveStringsA(
[in] DWORD nBufferLength,
[out] LPSTR lpBuffer
);
Parâmetros
[in] nBufferLength
O tamanho máximo do buffer apontado por lpBuffer, em TCHARs. Esse tamanho não inclui o caractere nulo de terminação. Se esse parâmetro for zero, lpBuffer não será usado.
[out] lpBuffer
Um ponteiro para um buffer que recebe uma série de cadeias de caracteres terminadas em nulo, uma para cada unidade válida no sistema, além de com um caractere nulo adicional. Cada cadeia de caracteres é um nome de dispositivo.
Retornar valor
Se a função for bem-sucedida, o valor retornado será o comprimento, em caracteres, das cadeias de caracteres copiadas para o buffer, não incluindo o caractere nulo de terminação. Observe que um caractere nulo ANSI-ASCII usa um byte, mas um caractere nulo Unicode (UTF-16) usa dois bytes.
Se o buffer não for grande o suficiente, o valor retornado será maior que nBufferLength. É o tamanho do buffer necessário para manter as cadeias de caracteres da unidade.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use a função GetLastError .
Comentários
Cada cadeia de caracteres no buffer pode ser usada onde quer que um diretório raiz seja necessário, como para as funções GetDriveType e GetDiskFreeSpace .
Essa função retorna uma concatenação das unidades nos namespaces global e local do dispositivo MS-DOS. Se houver uma unidade em ambos os namespaces, essa função retornará a entrada no namespace local do dispositivo MS-DOS. Para obter mais informações, consulte Definindo um nome de dispositivo MS DOS.
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 | No |
| TFO (Failover transparente) do SMB 3.0 | No |
| SMB 3.0 com compartilhamentos de arquivos de expansão (SO) | No |
| 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.
Exemplos
Para obter um exemplo, consulte Obtendo um nome de arquivo de um identificador de arquivo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |