FindFirstVolumeW 함수(fileapi.h)

컴퓨터에 있는 볼륨의 이름을 검색합니다. FindFirstVolume 은 컴퓨터 볼륨 검사를 시작하는 데 사용됩니다.

구문

HANDLE FindFirstVolumeW(
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

매개 변수

[out] lpszVolumeName

발견된 첫 번째 볼륨의 볼륨 GUID 경로를 지정하는 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다.

[in] cchBufferLength

TCHAR에서 볼륨 GUID 경로를 수신할 버퍼의 길이입니다.

반환 값

함수가 성공하면 반환 값은 FindNextVolume 및 FindVolumeClose 함수에 대한 후속 호출에 사용되는 검색 핸들입니다.

함수가 볼륨을 찾지 못하면 반환 값은 INVALID_HANDLE_VALUE 오류 코드입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

FindFirstVolume 함수는 볼륨 검색 핸들을 열고 컴퓨터에 있는 첫 번째 볼륨에 대한 정보를 반환합니다. 검색 핸들이 설정되면 FindNextVolume 함수를 사용하여 다른 볼륨을 검색할 수 있습니다. 검색 핸들이 더 이상 필요하지 않으면 FindVolumeClose 함수를 사용하여 닫습니다.

이러한 함수에서 반환되는 볼륨의 순서와 컴퓨터에 있는 볼륨의 순서 간에 상관 관계를 가정해서는 안 됩니다. 특히 BIOS(있는 경우) 또는 디스크 관리자가 할당한 볼륨 순서와 드라이브 문자 간에 어떤 상관 관계도 가정하지 마세요.

Windows 8 및 Windows Server 2012에서 이 함수는 다음 기술을 통해 지원됩니다.

SMB는 볼륨 관리 기능을 지원하지 않습니다.

예제

예제는 볼륨 경로 표시를 참조하세요.

요구 사항

참고 항목

FindNextVolume

FindVolumeClose

탑재된 폴더

볼륨 관리 함수