GetVolumePathNamesForVolumeNameW 함수(fileapi.h)

지정된 볼륨에 대한 드라이브 문자 및 탑재된 폴더 경로 목록을 검색합니다.

구문

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

매개 변수

[in] lpszVolumeName

볼륨의 볼륨 GUID 경로입니다. 볼륨 GUID 경로는 "\\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxx}\" 형식입니다.

[out] lpszVolumePathNames

드라이브 문자 및 탑재된 폴더 경로 목록을 수신하는 버퍼에 대한 포인터입니다. 목록은 추가 NULL 문자에 의해 종료된 null 로 끝나는 문자열의 배열입니다. 버퍼가 전체 목록을 보유할 만큼 크지 않은 경우 버퍼는 가능한 한 많은 목록을 보유합니다.

[in] cchBufferLength

모든 NULL 문자를 포함하여 TCHAR에서 lpszVolumePathNames 버퍼의 길이입니다.

[out] lpcchReturnLength

호출에 성공하면 이 매개 변수는 lpszVolumePathNames 버퍼에 복사된 TCHAR의 수입니다. 그렇지 않으면 이 매개 변수는 TCHAR에서 전체 목록을 보유하는 데 필요한 버퍼의 크기입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 버퍼가 전체 목록을 저장할 만큼 크지 않으면 오류 코드가 ERROR_MORE_DATAlpcchReturnLength 매개 변수는 필요한 버퍼 크기를 받습니다.

설명

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

참고 항목

탑재된 폴더

볼륨 관리 함수