GetVolumePathNamesForVolumeNameA 함수(winbase.h)

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

구문

BOOL GetVolumePathNamesForVolumeNameA(
  [in]  LPCSTR lpszVolumeName,
  [out] LPCH   lpszVolumePathNames,
  [in]  DWORD  cchBufferLength,
  [out] PDWORD lpcchReturnLength
);

매개 변수

[in] lpszVolumeName

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

[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는 볼륨 관리 기능을 지원하지 않습니다.

예제

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

요구 사항

참고 항목

탑재된 폴더

볼륨 관리 함수