GetVolumeNameForVolumeMountPointW 함수(fileapi.h)

  • 아티클

지정된 볼륨 탑재 지점(드라이브 문자, 볼륨 GUID 경로 또는 탑재된 폴더)과 연결된 볼륨의 볼륨 GUID 경로를 검색합니다.

구문

BOOL GetVolumeNameForVolumeMountPointW(
  [in]  LPCWSTR lpszVolumeMountPoint,
  [out] LPWSTR  lpszVolumeName,
  [in]  DWORD   cchBufferLength
);

매개 변수

[in] lpszVolumeMountPoint

탑재된 폴더의 경로(예: "Y:\MountX\") 또는 드라이브 문자(예: "X:\")가 포함된 문자열에 대한 포인터입니다. 문자열은 후행 백슬래시('\')로 끝나야 합니다.

[out] lpszVolumeName

볼륨 GUID 경로를 수신하는 문자열에 대한 포인터입니다. 이 경로는 "\\?\Volume{GUID}\" 형식입니다. 여기서 GUID 는 볼륨을 식별하는 GUID 입니다. 볼륨에 대해 둘 이상의 볼륨 GUID 경로가 있는 경우 탑재 관리자의 캐시에 있는 첫 번째 경로만 반환됩니다.

[in] cchBufferLength

TCHAR의 출력 버퍼 길이입니다. 버퍼가 가능한 가장 큰 볼륨 GUID 경로를 수용할 수 있는 적절한 크기는 50자입니다.

반환 값

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

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

GetVolumeNameForVolumeMountPoint를 사용하여 입력 매개 변수로 볼륨 GUID 경로가 필요한 SetVolumeMountPoint 및 FindFirstVolumeMountPoint와 같은 함수와 함께 사용할 볼륨 GUID 경로를 가져옵니다. 볼륨 GUID 경로에 대한 자세한 내용은 볼륨 이름 지정을 참조하세요.

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) No
 

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

탑재 지점은 ReFS 볼륨에서 지원되지 않습니다.

요구 사항

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

참고 항목

DeleteVolumeMountPoint

GetVolumePathName

탑재된 폴더

SetVolumeMountPoint

볼륨 관리 함수