Función GetFileType (fileapi.h)
Recupera el tipo del archivo especificado.
Sintaxis
DWORD GetFileType(
[in] HANDLE hFile
);
Parámetros
[in] hFile
Identificador del archivo.
Valor devuelto
La función devuelve uno de los valores siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
El archivo especificado es un archivo de caracteres, normalmente un dispositivo LPT o una consola. |
|
El archivo especificado es un archivo de disco. |
|
El archivo especificado es un socket, una canalización con nombre o una canalización anónima. |
|
Sin usar. |
|
El tipo del archivo especificado es desconocido o se produjo un error en la función. |
Puede distinguir entre una devolución "válida" de FILE_TYPE_UNKNOWN y su devolución debido a un error de llamada (por ejemplo, pasar un identificador no válido a GetFileType) llamando a GetLastError.
Si la función funcionaba correctamente y se devolvió FILE_TYPE_UNKNOWN, una llamada a GetLastError devolverá NO_ERROR.
Si la función devolvió FILE_TYPE_UNKNOWN debido a un error al llamar a GetFileType, GetLastError devolverá el código de error.
Comentarios
En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.
| Tecnología | Compatible |
|---|---|
| Protocolo Bloque de mensajes del servidor (SMB) 3.0 | Sí |
| Conmutación por error transparente (TFO) de SMB 3.0 | Sí |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | Sí |
| Sistema de archivos de Volumen compartido de clúster (CsvFS) | Sí |
| Sistema de archivos resistente a errores (ReFS) | Sí |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | fileapi.h (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |