GetDriveTypeA-Funktion (fileapi.h)

Bestimmt, ob es sich bei einem Laufwerk um ein Wechsellaufwerk, ein festes Laufwerk, eine CD-ROM, eine RAM-Disk oder ein Netzlaufwerk handelt.

Rufen Sie SetupDiGetDeviceRegistryProperty auf, und geben Sie die eigenschaft SPDRP_REMOVAL_POLICY an, um zu ermitteln, ob es sich bei einem Laufwerk um ein USB-Laufwerk handelt.

Syntax

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

Parameter

[in, optional] lpRootPathName

Das Stammverzeichnis für das Laufwerk.

Ein nachgestellter umgekehrter Schrägstrich ist erforderlich. Wenn dieser Parameter NULL ist, verwendet die Funktion den Stamm des aktuellen Verzeichnisses.

Rückgabewert

Der Rückgabewert gibt den Typ des Laufwerks an, bei dem es sich um einen der folgenden Werte handeln kann.

Rückgabecode/-wert BESCHREIBUNG
DRIVE_UNKNOWN
0
Der Laufwerktyp kann nicht bestimmt werden.
DRIVE_NO_ROOT_DIR
1
Der Stammpfad ist ungültig. Beispielsweise ist kein Volume am angegebenen Pfad eingebunden.
DRIVE_REMOVABLE
2
Das Laufwerk verfügt über Wechselmedien; beispielsweise ein Diskettenlaufwerk, ein USB-Laufwerk oder ein Flash-Karte Reader.
DRIVE_FIXED
3
Das Laufwerk verfügt über feste Medien. z. B. ein Festplattenlaufwerk oder ein Flashlaufwerk.
DRIVE_REMOTE
4
Das Laufwerk ist ein Remotelaufwerk (Netzwerklaufwerk).
DRIVE_CDROM
5
Das Laufwerk ist ein CD-ROM-Laufwerk.
DRIVE_RAMDISK
6
Das Laufwerk ist ein RAM-Datenträger.

Hinweise

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie Unterstützt
SMB 3.0-Protokoll (Server Message Block) Nein
SMB 3.0 Transparent Failover (TFO) Nein
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) Nein
Dateisystem mit freigegebenen Clustervolumes (CsvFS) Ja
Robustes Dateisystem (Resilient File System, ReFS) Ja
 

SMB unterstützt keine Volumeverwaltungsfunktionen.

Hinweis

Der Fileapi.h-Header definiert GetDriveType als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile fileapi.h (Einschließen von Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetDiskFreeSpace

Volumeverwaltungsfunktionen