Função FindFirstVolumeW (fileapi.h)

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.

O SMB não dá suporte a funções de gerenciamento de volume.

Exemplos

Para obter um exemplo, consulte Exibindo caminhos de volume.

Requisitos

Confira também

FindNextVolume

FindVolumeClose

Pastas montadas

Funções de gerenciamento de volumes