다음을 통해 공유

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-xxxxxxxxxx}\" 형식입니다.

[out] lpszVolumePathNames

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

[in] cchBufferLength

모든 NULL 문자를 포함하여 WCHARlpszVolumePathNames 버퍼의 길이입니다.

[out] lpcchReturnLength

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

반환 값

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

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

발언

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

기술 지원
SMB(서버 메시지 블록) 3.0 프로토콜 아니요
SMB 3.0 TFO(투명한 장애 조치(failover) 아니요
SO(스케일 아웃 파일 공유)가 있는 SMB 3.0 아니요
CsvFS(클러스터 공유 볼륨 파일 시스템) 예
ReFS(복원 파일 시스템) 예
 

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

예제

예를 들어 볼륨 경로 표시참조하세요.

요구 사항

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

참고 항목

탑재된 폴더

볼륨 관리 함수