Compartilhar via


Função FindClose (fileapi.h)

Fecha um identificador de pesquisa de arquivo aberto pelas funções FindFirstFile, FindFirstFileEx, FindFirstFileNameW, FindFirstFileNameTransactedW, FindFirstFileTransacted, FindFirstStreamTransactedW ou FindFirstStreamW .

Sintaxe

BOOL FindClose(
  [in, out] HANDLE hFindFile
);

Parâmetros

[in, out] hFindFile

O identificador de pesquisa de arquivo.

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 FindClose é chamada, o identificador especificado pelo parâmetro hFindFile não pode ser usado em chamadas subsequentes para as funções FindNextFile, FindNextFileNameW, FindNextStreamW ou FindClose .

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 Sim
TFO (Failover transparente) do SMB 3.0 Sim
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) Sim
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim
 

Exemplos

Para obter um exemplo, consulte Listando os arquivos em um diretório.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho fileapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de gerenciamento de arquivos

FindFirstFile

FindFirstFileEx

FindFirstFileNameTransactedW

FindFirstFileNameW

FindFirstFileTransacted

FindFirstStreamTransactedW

FindFirstStreamW

FindNextFile

FindNextFileNameW

FindNextStreamW