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

Confira também

FindNextVolume

FindVolumeClose

Pastas montadas

Funções de gerenciamento de volumes