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 프로토콜 Yes
SMB 3.0 TFO(투명 장애 조치(failover)) No
SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 No
CsvFS(클러스터 공유 볼륨 파일 시스템) Yes
ReFS(Resilient File System) Yes

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 fileapi.h(Windows.h, WinBase.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

파일 관리 함수

FindClose

FindFirstFileNameW