Função GetLogicalDriveStringsA (winbase.h)

  • Artigo

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

Confira também

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Funções de gerenciamento de volumes