共用方式為


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 通訊協定 Yes
SMB 3.0 透明故障轉移 (TFO) Yes
具有向外延展檔案共用的SMB 3.0 (SO) Yes
叢集共用磁碟區文件系統 (CsvFS) Yes
彈性檔案系統 (ReFS) Yes

規格需求

需求
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 fileapi.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

檔案管理功能

GetFileSize

GetFileTime