GetFileType 関数 (fileapi.h)

指定したファイルのファイルの種類を取得します。

構文

DWORD GetFileType(
  [in] HANDLE hFile
);

[in] hFile

ファイルへのハンドル。

関数は、次のいずれかの値を返します。

リターンコード/値	Description
FILE_TYPE_CHAR 0x0002	指定されたファイルは文字ファイルであり、通常は LPT デバイスまたはコンソールです。
FILE_TYPE_DISK 0x0001	指定されたファイルはディスクファイルです。
FILE_TYPE_PIPE 0x0003	指定されたファイルは、ソケット、名前付きパイプ、または匿名パイプです。
FILE_TYPE_REMOTE 0x8000	未使用。
FILE_TYPE_UNKNOWN 0x0000	指定したファイルの型が不明であるか、関数が失敗しました。

GetLastError を呼び出すことで、呼び出しエラー (たとえば、無効なハンドルを GetFileType に渡す) により、FILE_TYPE_UNKNOWNの "有効な" 戻り値とその戻り値を区別できます。

関数が正常に機能し、 FILE_TYPE_UNKNOWN が返された場合、 GetLastError の呼び出しは NO_ERRORを返します。

GetFileType の呼び出し中にエラーが発生したために関数がFILE_TYPE_UNKNOWN返された場合、GetLastError はエラーコードを返します。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

テクノロジ	サポートされています
サーバーメッセージブロック (SMB) 3.0 プロトコル	はい
SMB 3.0 Transparent Failover (TFO)	はい
スケールアウトファイル共有 (SO) を使う SMB 3.0	はい
クラスターの共有ボリュームファイルシステム (CsvFS)	はい
Resilient File System (ReFS)	はい

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	fileapi.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll