Função FindVolumeClose (fileapi.h)

  • Artigo

Fecha a alça de pesquisa de volume especificada. As funções FindFirstVolume e FindNextVolume usam esse identificador de pesquisa para localizar volumes.

Sintaxe

BOOL FindVolumeClose(
  [in] HANDLE hFindVolume
);

Parâmetros

[in] hFindVolume

O identificador de pesquisa de volume a ser fechado. Esse identificador deve ter sido aberto anteriormente pela função FindFirstVolume .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Depois que a função FindVolumeClose for chamada, o identificador hFindVolume não poderá ser usado em chamadas subsequentes para FindNextVolume ou FindVolumeClose.

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

Confira também

FindFirstVolume

FindNextVolume

Pastas montadas

Funções de gerenciamento de volumes