FindNextFileA 関数 (fileapi.h)

  • [アーティクル]

FindFirstFile 関数、FindFirstFileEx 関数、または FindFirstFileTransacted 関数への以前の呼び出しからファイル検索を続行します。

構文

BOOL FindNextFileA(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAA lpFindFileData
);

パラメーター

[in] hFindFile

FindFirstFile または FindFirstFileEx 関数の以前の呼び出しによって返される検索ハンドル。

[out] lpFindFileData

見つかったファイルまたはサブディレクトリに関する情報を受け取る WIN32_FIND_DATA 構造体へのポインター。

戻り値

関数が成功した場合、戻り値は 0 以外であり、 lpFindFileData パラメーターには、次に見つかったファイルまたはディレクトリに関する情報が含まれます。

関数が失敗した場合、戻り値は 0 で、 lpFindFileData の内容は不確定になります。 エラーの詳細情報を得るには、GetLastError 関数を呼び出します。

一致するファイルが見つからないために関数が失敗した場合、 GetLastError 関数は ERROR_NO_MORE_FILESを返します。

注釈

この関数は、 hFindFile パラメーターで渡される検索ハンドルを作成するために使用されたのと同じ検索フィルターを使用します。 詳細については、「 FindFirstFile」 および「 FindFirstFileEx」を参照してください。

検索によってファイルが返される順序 (アルファベット順など) は保証されず、ファイル システムに依存します。 データを並べ替える必要がある場合、アプリケーションは、すべての結果を取得した後に順序付けを行う必要があります。

メモ まれに、または負荷の高いシステムでは、この関数が呼び出された時点で NTFS ファイル システムのファイル属性情報が最新ではない可能性があります。 現在の NTFS ファイル システム ファイル属性を確実に取得するには、 GetFileInformationByHandle 関数を呼び出します。
 
この関数がファイル名を返す順序は、ファイル システムの種類によって異なります。 NTFS ファイル システムと CDFS ファイル システムでは、通常、名前はアルファベット順に返されます。 FAT ファイル システムでは、通常、ファイルがディスクに書き込まれた順序で名前が返されます。アルファベット順の場合とそうでない場合があります。 ただし、前述のように、これらの動作は保証されません。

パスがシンボリック リンクを指している場合、WIN32_FIND_DATA バッファーにはターゲットではなくシンボリック リンクの情報が含まれます。

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

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

Transacted Operations

ファイル列挙ハンドルにバインドされたトランザクションがある場合、返されるファイルはトランザクション分離規則の適用対象になります。

例

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

注意

fileapi.h ヘッダーは、FindNextFile をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

File Management 関数

FindClose

FindFirstFile

FindFirstFileEx

GetFileAttributes

SetFileAttributes

シンボリック リンク

WIN32_FIND_DATA