GetDriveTypeA 함수(fileapi.h)

  • 아티클

디스크 드라이브가 이동식, 고정식, CD-ROM, RAM 디스크 또는 네트워크 드라이브인지 여부를 확인합니다.

드라이브가 USB 형식 드라이브인지 확인하려면 SetupDiGetDeviceRegistryProperty 를 호출하고 SPDRP_REMOVAL_POLICY 속성을 지정합니다.

구문

UINT GetDriveTypeA(
  [in, optional] LPCSTR lpRootPathName
);

매개 변수

[in, optional] lpRootPathName

드라이브의 루트 디렉터리입니다.

후행 백슬래시가 필요합니다. 이 매개 변수가 NULL이면 함수는 현재 디렉터리의 루트를 사용합니다.

반환 값

반환 값은 다음 값 중 하나일 수 있는 드라이브 유형을 지정합니다.

반환 코드/값 설명
DRIVE_UNKNOWN
0
 드라이브 유형을 확인할 수 없습니다.
DRIVE_NO_ROOT_DIR
1
 루트 경로가 잘못되었습니다. 예를 들어 지정된 경로에 탑재된 볼륨이 없습니다.
DRIVE_REMOVABLE
2
 드라이브에 이동식 미디어가 있습니다. 예를 들어 플로피 드라이브, 썸 드라이브 또는 플래시 카드 판독기입니다.
DRIVE_FIXED
3
 드라이브에 고정 미디어가 있습니다. 예를 들어 하드 디스크 드라이브 또는 플래시 드라이브입니다.
DRIVE_REMOTE
4
 드라이브는 원격(네트워크) 드라이브입니다.
DRIVE_CDROM
5
 드라이브는 CD-ROM 드라이브입니다.
DRIVE_RAMDISK
6
 드라이브가 RAM 디스크입니다.

설명

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

참고

fileapi.h 헤더는 GETDriveType을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

참고 항목

GetDiskFreeSpace

볼륨 관리 함수