GetFileType-Funktion (fileapi.h)

  • Artikel

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