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.

Sintaksis

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 pengembalian 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.

Komentar

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

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Tidak
Failover Transparan (TFO) SMB 3.0 Tidak
SMB 3.0 dengan Scale-out File Shares (SO) Tidak
Sistem File Volume Bersama Kluster (CsvFS) Ya
Sistem File Tangguh (ReFS) Ya
 

SMB tidak mendukung fungsi manajemen volume.

Nota

Header fileapi.h mendefinisikan GetDriveType sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Syarat Nilai
klien minimum yang didukung Windows XP [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Platform Target Windows
Header fileapi.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

GetDiskFreeSpace

Fungsi Manajemen Volume