fileapi.h
GetFileType
Recupera el tipo del fichero especificado.
DWORD GetFileType(
HANDLE hFile
);
Parámetros
- hFile
- Un manipulador del fichero.
Valor de retorno
La función devuelve uno de los siguientes valores:
| Código de retorno/valor | Descripción |
|---|---|
| FILE_TYPE_CHAR 0x0002 |
El fichero especifiado es un fichero de caracteres, generalmente un fichero LPT o una consola. |
| FILE_TYPE_DISK 0x0001 |
El fichero especificado es un fichero de disco. |
| FILE_TYPE_PIPE 0x0003 |
El fichero especificad es un socket, una tubería con nombre o anónima. |
| FILE_TYPE_REMOTE 0x8000 |
No usado. |
| FILE_TYPE_UNKNOWN 0x0000 |
O bien el tipo de fichero especificado es desconocido, o la función ha fallado. |
Se puede distinguir entre un retorno "válido" de FILE_TYPE_UNKNOWN y el mismo retorno para una llamada erronea (por ejemplo, pasando un manipukador inválido a GetFileType) mediante una llamada a GetLastError.
Si la función funciona apropiadamente y retorna FILE_TYPE_UNKNOWN, una llamada a GetLastError retornará NO_ERROR.
Si la función retorna FILE_TYPE_UNKNOWN indicando un error en la llamada a GetFileType, GetLastError retornará un código de error.
Observaciones
En Windows 8 y Windows Server 2012, esta función está soportada para las tecnologías siguientes:
| Tecnología | Soporte |
|---|---|
| Server Message Block (SMB) 3.0 protocol | Si |
| SMB 3.0 Transparent Failover (TFO) | Si |
| SMB 3.0 with Scale-out File Shares (SO) | Si |
| Cluster Shared Volume File System (CsvFS) | Si |
| Resilient File System (ReFS) | Si |