Compartir a través de


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
Conmutación por error transparente (TFO) de SMB 3.0
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)
Sistema de archivos de Volumen compartido de clúster (CsvFS)
Sistema de archivos resistente a errores (ReFS)

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