FindClose 関数 (fileapi.h)

FindFirstFileFindFirstFileEx、FindFirstFileNameWFindFirstFileNameTransactedW、FindFirstFileTransactedFindFirstStreamTransactedW、または FindFirstStreamW 関数によって開かれたファイル検索ハンドルを閉じます。

構文

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

パラメーター

[in, out] hFindFile

ファイル検索ハンドル。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

FindClose 関数を呼び出した後、hFindFile パラメーターで指定されたハンドルは、FindNextFile、FindNextFileNameWFindNextStreamW、または FindClose 関数の後続の呼び出しでは使用できません。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

テクノロジ サポートされています
サーバー メッセージ ブロック (SMB) 3.0 プロトコル はい
SMB 3.0 Transparent Failover (TFO) はい
スケールアウト ファイル共有 (SO) を使う SMB 3.0 はい
クラスターの共有ボリューム ファイル システム (CsvFS) はい
Resilient File System (ReFS) はい
 

例については、「 ディレクトリ内のファイルの一覧表示」を参照してください。

要件

要件
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー fileapi.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

File Management 関数

FindFirstFile

FindFirstFileEx

FindFirstFileNameTransactedW

FindFirstFileNameW

FindFirstFileTransacted

FindFirstStreamTransactedW

FindFirstStreamW

FindNextFile

FindNextFileNameW

FindNextStreamW