指定したファイルのファイルの種類を取得します。
構文
DWORD GetFileType(
[in] HANDLE hFile
);
パラメーター
[in] hFile
ファイルへのハンドル。
戻り値
関数は、次のいずれかの値を返します。
| リターン コード/値 | Description |
|---|---|
|
指定されたファイルは文字ファイルであり、通常は LPT デバイスまたはコンソールです。 |
|
指定されたファイルはディスク ファイルです。 |
|
指定されたファイルは、ソケット、名前付きパイプ、または匿名パイプです。 |
|
未使用。 |
|
指定したファイルの型が不明であるか、関数が失敗しました。 |
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 |