Função FindFirstVolumeA (winbase.h)
Retorna o nome de um volume em um computador. FindFirstVolume é usado para começar a digitalizar os volumes de um computador.
Sintaxe
HANDLE FindFirstVolumeA(
[out] LPSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parâmetros
[out] lpszVolumeName
Um ponteiro para um buffer que recebe uma cadeia de caracteres terminada em nulo que especifica um caminho GUID de volume para o primeiro volume encontrado.
[in] cchBufferLength
O comprimento do buffer para receber o caminho guid de volume, em TCHARs.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um identificador de pesquisa usado em uma chamada subsequente para as funções FindNextVolume e FindVolumeClose .
Se a função não encontrar volumes, o valor retornado será o código de erro INVALID_HANDLE_VALUE . Para obter informações de erro estendidas, chame GetLastError.
Comentários
A função FindFirstVolume abre um identificador de pesquisa de volume e retorna informações sobre o primeiro volume encontrado em um computador. Depois que o identificador de pesquisa for estabelecido, você poderá usar a função FindNextVolume para pesquisar outros volumes. Quando o identificador de pesquisa não for mais necessário, feche-o usando a função FindVolumeClose .
Você não deve assumir qualquer correlação entre a ordem dos volumes retornados por essas funções e a ordem dos volumes que estão no computador. Em particular, não assuma nenhuma correlação entre a ordem do volume e as letras da unidade, conforme atribuído pelo BIOS (se houver) ou pelo Administrador de Disco.
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 Exibindo caminhos de volume.
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 |