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 |
|---|---|
|
Der Laufwerktyp kann nicht bestimmt werden. |
|
Der Stammpfad ist ungültig. Beispielsweise ist kein Volume am angegebenen Pfad eingebunden. |
|
Das Laufwerk verfügt über Wechselmedien; beispielsweise ein Diskettenlaufwerk, ein USB-Laufwerk oder ein Flash-Karte Reader. |
|
Das Laufwerk verfügt über feste Medien. z. B. ein Festplattenlaufwerk oder ein Flashlaufwerk. |
|
Das Laufwerk ist ein Remotelaufwerk (Netzwerklaufwerk). |
|
Das Laufwerk ist ein CD-ROM-Laufwerk. |
|
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 |