Função FindVolumeClose (fileapi.h)
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 |