GetDriveTypeA-Funktion (fileapi.h)
Bestimmt, ob es sich bei einem Laufwerk um ein Wechseldatenträger, ein Festes, cd-ROM, EINEN RAM-Datenträger oder ein Netzlaufwerk handelt.
Rufen Sie SetupDiGetDeviceRegistryProperty- auf, um festzustellen, ob es sich bei einem Laufwerk um ein USB-Laufwerk handelt, und geben Sie die eigenschaft SPDRP_REMOVAL_POLICY an.
Syntax
UINT GetDriveTypeA(
[in, optional] LPCSTR lpRootPathName
);
Parameter
[in, optional] lpRootPathName
Das Stammverzeichnis für das Laufwerk.
Ein nachfolgender 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.
| Zurückgeben von Code/Wert | Beschreibung |
|---|---|
|
Der Laufwerktyp kann nicht bestimmt werden. |
|
Der Stammpfad ist ungültig. Es gibt z. B. kein Volume, das am angegebenen Pfad bereitgestellt wird. |
|
Das Laufwerk verfügt über Wechselmedien; Beispielsweise ein Diskettenlaufwerk, ein Usb-Laufwerk oder ein Flashkartenleser. |
|
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. |
Bemerkungen
In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
| Technologie | Abgestützt |
|---|---|
| Server Message Block (SMB) 3.0-Protokoll | Nein |
| SMB 3.0 Transparent Failover (TFO) | Nein |
| SMB 3.0 mit Skalierungsdateifreigaben (SO) | Nein |
| Freigegebenes Clustervolumedateisystem (CsvFS) | Ja |
| Resilient File System (ReFS) | Ja |
SMB unterstützt keine Volumeverwaltungsfunktionen.
Anmerkung
Der Fileapi.h-Header definiert GetDriveType als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | fileapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |