Skip to content

Latest commit

 

History

History
158 lines (121 loc) · 3.48 KB

nf-fileapi-findnextfilenamew.md

File metadata and controls

158 lines (121 loc) · 3.48 KB
UIDtitledescriptionhelpviewer_keywordsold-locationtech.rootms.assetidms.datems.keywordsreq.headerreq.include-headerreq.target-typereq.target-min-winverclntreq.target-min-winversvrreq.kmdf-verreq.umdf-verreq.ddi-compliancereq.unicode-ansireq.idlreq.max-supportreq.namespacereq.assemblyreq.type-libraryreq.libreq.dllreq.irqltargetosreq.typenamesreq.redistms.customf1_keywordsdev_langstopic_typeapi_typeapi_locationapi_name
NF:fileapi.FindNextFileNameW
FindNextFileNameW function (fileapi.h)
Continues enumerating the hard links to a file using the handle returned by a successful call to the FindFirstFileNameW function.
FindNextFileNameW
FindNextFileNameW function [Files]
fileapi/FindNextFileNameW
fs.findnextfilenamew
fs\findnextfilenamew.htm
fs
1d2f8041-2744-4f37-afde-ddce49a8bdc5
12/05/2018
FindNextFileNameW, FindNextFileNameW function [Files], fileapi/FindNextFileNameW, fs.findnextfilenamew
fileapi.h
Windows.h, WinBase.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Kernel32.lib
Kernel32.dll
Windows
19H1
FindNextFileNameW
fileapi/FindNextFileNameW
c++
APIRef
kbSyntax
DllExport
Kernel32.dll
API-MS-Win-Core-File-L1-2-2.dll
KernelBase.dll
FindNextFileNameW

FindNextFileNameW function

-description

Continues enumerating the hard links to a file using the handle returned by a successful call to the FindFirstFileNameW function.

-parameters

-param hFindStream [in]

A handle to the enumeration that is returned by a successful call to FindFirstFileNameW.

-param StringLength [in, out]

The size of the LinkName parameter, in characters. If this call fails and the error is ERROR_MORE_DATA, the value that is returned by this parameter is the size that LinkName must be to contain all the data.

-param LinkName [in, out]

A pointer to a buffer to store the first link name found for lpFileName.

-returns

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero (0). To get extended error information, call GetLastError.

If no matching files can be found, the GetLastError function returns ERROR_HANDLE_EOF.

-remarks

If the function returns TRUE, there are more hard links to enumerate.

In Windows 8 and Windows Server 2012, this function is supported by the following technologies.

TechnologySupported
Server Message Block (SMB) 3.0 protocol Yes
SMB 3.0 Transparent Failover (TFO) No
SMB 3.0 with Scale-out File Shares (SO) No
Cluster Shared Volume File System (CsvFS) Yes
Resilient File System (ReFS) Yes

-see-also

File Management Functions

FindClose

FindFirstFileNameW

close