Função FindFirstVolumeW (fileapi.h)

  • Artigo

Retorna o nome de um volume em um computador. FindFirstVolume é usado para começar a examinar os volumes de um computador.

Sintaxe

HANDLE FindFirstVolumeW(
  [out] LPWSTR 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 do volume, em TCHARs.

Valor retornado

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 nenhuma 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 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 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

   
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 fileapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

FindNextVolume

FindVolumeClose

Pastas montadas

Funções de gerenciamento de volumes