FindNextFileNameW 関数 (fileapi.h)

FindFirstFileNameW 関数への呼び出しの成功により返されたハンドルを使って、ファイルへのハードリンクを列挙し続けます。

構文

BOOL FindNextFileNameW(
  [in]      HANDLE  hFindStream,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

[in] hFindStream

FindFirstFileNameW の正常な呼び出しによって返される列挙へのハンドル。

[in, out] StringLength

LinkName パラメーターのサイズ (文字単位)。この呼び出しが失敗し、エラーが ERROR_MORE_DATA場合、このパラメーターによって返される値は、すべてのデータを格納するために LinkName に必要なサイズです。

[in, out] LinkName

lpFileName で見つかった最初のリンク名を格納するバッファーへのポインター。

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

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

一致するファイルが見つからない場合、 GetLastError 関数は ERROR_HANDLE_EOFを返します。

関数が TRUE を返す場合は、列挙するハードリンクがさらに存在します。

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

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


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