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
FILE_TYPE_CHAR 0x0002	El archivo especificado es un archivo de caracteres, normalmente un dispositivo LPT o una consola.
FILE_TYPE_DISK 0x0001	El archivo especificado es un archivo de disco.
FILE_TYPE_PIPE 0x0003	El archivo especificado es un socket, una canalización con nombre o una canalización anónima.
FILE_TYPE_REMOTE 0x8000	Sin usar.
FILE_TYPE_UNKNOWN 0x0000	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

Vea también

Funciones de administración de archivos

GetFileSize

GetFileTime