FindVolumeClose 함수(fileapi.h)
지정된 볼륨 검색 핸들을 닫습니다. FindFirstVolume 및 FindNextVolume 함수는 이 검색 핸들을 사용하여 볼륨을 찾습니다.
구문
BOOL FindVolumeClose(
[in] HANDLE hFindVolume
);
매개 변수
[in] hFindVolume
닫을 볼륨 검색 핸들입니다. 이 핸들은 이전에 FindFirstVolume 함수에 의해 열렸어야 합니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
FindVolumeClose 함수가 호출된 후에는 FindNextVolume 또는 FindVolumeClose에 대한 후속 호출에서 hFindVolume 핸들을 사용할 수 없습니다.
Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.
| 기술 | 지원됨 |
|---|---|
| SMB(서버 메시지 블록) 3.0 프로토콜 | No |
| SMB 3.0 TFO(투명 장애 조치(failover)) | No |
| SO(스케일 아웃 파일 공유)를 사용하는 SMB 3.0 | No |
| CsvFS(클러스터 공유 볼륨 파일 시스템) | Yes |
| ReFS(Resilient File System) | Yes |
SMB는 볼륨 관리 기능을 지원하지 않습니다.
예제
예제는 볼륨 경로 표시를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | fileapi.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |