getFileType 函数 (fileapi.h)
检索指定文件的文件类型。
语法
DWORD GetFileType(
[in] HANDLE hFile
);
参数
[in] hFile
文件的句柄。
返回值
函数返回以下值之一。
| 返回代码/值 | 说明 |
|---|---|
|
指定的文件是字符文件，通常是 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 透明故障转移 (TFO) | 是 |
| 具有横向扩展文件共享的 SMB 3.0 (SO) | 是 |
| 群集共享卷文件系统 (CSV) | 是 |
| 弹性文件系统 (ReFS) | 是 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | fileapi.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |