Bagikan melalui

Fungsi GetDriveTypeA (fileapi.h)

  • Artikel

Menentukan apakah drive disk dapat dilepas, diperbaiki, CD-ROM, disk RAM, atau drive jaringan.

Untuk menentukan apakah drive adalah drive jenis USB, panggil SetupDiGetDeviceRegistryProperty dan tentukan properti SPDRP_REMOVAL_POLICY .

Sintaks

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

Parameter

[in, optional] lpRootPathName

Direktori akar untuk drive.

Garis miring terbelakang diperlukan. Jika parameter ini NULL, fungsi menggunakan akar direktori saat ini.

Mengembalikan nilai

Nilai yang dikembalikan menentukan jenis drive, yang bisa menjadi salah satu nilai berikut.

Mengembalikan kode/nilai Deskripsi
DRIVE_UNKNOWN
0
 Tipe kandar tidak dapat ditentukan.
DRIVE_NO_ROOT_DIR
1
 Jalur akar tidak valid; misalnya, tidak ada volume yang dipasang pada jalur yang ditentukan.
DRIVE_REMOVABLE
2
 Kandar memiliki media yang dapat dilepas; misalnya, drive floppy, drive jempol, atau pembaca kartu flash.
DRIVE_FIXED
3
 Kandar memiliki media tetap; misalnya, hard disk drive atau flash drive.
DRIVE_REMOTE
4
 Drive adalah drive jarak jauh (jaringan).
DRIVE_CDROM
5
 Drive adalah drive CD-ROM.
DRIVE_RAMDISK
6
 Drive adalah disk RAM.

Keterangan

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Tidak
SMB 3.0 Transparent Failover (TFO) Tidak
SMB 3.0 dengan Berbagi File Peluasan Skala (SO) Tidak
Sistem File Volume Bersama Kluster (CsvFS) Ya
Sistem File Tangguh (ReFS) Ya
 

SMB tidak mendukung fungsi manajemen volume.

Catatan

Header fileapi.h mendefinisikan GetDriveType sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

   
Klien minimum yang didukung Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header fileapi.h (sertakan Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

GetDiskFreeSpace

Fungsi Manajemen Volume