GetFileType-Funktion (fileapi.h)

Ruft den Dateityp der angegebenen Datei ab.

Syntax

DWORD GetFileType(
  [in] HANDLE hFile
);

Parameter

[in] hFile

Ein Handle zur Datei.

Rückgabewert

Die Funktion gibt einen der folgenden Werte zurück.

Rückgabecode/-wert	BESCHREIBUNG
FILE_TYPE_CHAR 0x0002	Die angegebene Datei ist eine Zeichendatei, in der Regel ein LPT-Gerät oder eine Konsole.
FILE_TYPE_DISK 0x0001	Die angegebene Datei ist eine Datenträgerdatei.
FILE_TYPE_PIPE 0x0003	Die angegebene Datei ist ein Socket, eine Named Pipe oder eine anonyme Pipe.
FILE_TYPE_REMOTE 0x8000	Nicht verwendet.
FILE_TYPE_UNKNOWN 0x0000	Entweder ist der Typ der angegebenen Datei unbekannt, oder die Funktion ist fehlgeschlagen.

 

Sie können zwischen einer "gültigen" Rückgabe von FILE_TYPE_UNKNOWN und seiner Rückgabe aufgrund eines Aufruffehlers (z. B. übergeben eines ungültigen Handles an GetFileType) unterscheiden, indem Sie GetLastError aufrufen.

Wenn die Funktion ordnungsgemäß funktioniert hat und FILE_TYPE_UNKNOWN zurückgegeben wurde, gibt ein Aufruf von GetLastErrorNO_ERROR zurück.

Wenn die Funktion aufgrund eines Fehlers beim Aufrufen von GetFileTypeFILE_TYPE_UNKNOWN zurückgegeben hat, gibt GetLastError den Fehlercode zurück.

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)	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

Anforderungen

Anforderung	Wert
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

Dateiverwaltungsfunktionen

GetFileSize

GetFileTime