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 |
|---|---|
|
Die angegebene Datei ist eine Zeichendatei, in der Regel ein LPT-Gerät oder eine Konsole. |
|
Die angegebene Datei ist eine Datenträgerdatei. |
|
Die angegebene Datei ist ein Socket, eine Named Pipe oder eine anonyme Pipe. |
|
Nicht verwendet. |
|
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 |