GetFileType function
Applies to: desktop apps only
Retrieves the file type of the specified file.
Syntax
DWORD WINAPI GetFileType( __in HANDLE hFile );
Parameters
- hFile [in]
-
A handle to the file.
Return value
The function returns one of the following values.
| Return code/value | Description |
|---|---|
|
The specified file is a character file, typically an LPT device or a console. |
|
The specified file is a disk file. |
|
The specified file is a socket, a named pipe, or an anonymous pipe. |
|
Unused. |
|
Either the type of the specified file is unknown, or the function failed. |
You can distinguish between a "valid" return of FILE_TYPE_UNKNOWN and its return due to a calling error (for example, passing an invalid handle to GetFileType) by calling GetLastError.
If the function worked properly and FILE_TYPE_UNKNOWN was returned, a call to GetLastError will return NO_ERROR.
If the function returned FILE_TYPE_UNKNOWN due to an error in calling GetFileType, GetLastError will return the error code.
Requirements
|
Minimum supported client | Windows XP |
|---|---|
|
Minimum supported server | Windows Server 2003 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
Send comments about this topic to Microsoft
Build date: 4/17/2012
- 12/5/2011
- cheong00
[DllImport("kernel32.dll")]
internal static extern int GetFileType(SafeFileHandle handle);
<DllImport("kernel32.dll")> _
Public Shared Function GetFileType(ByVal handle As SafeFileHandle) As Integer
End Function
