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/valorDescripció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íaSoporte
Server Message Block (SMB) 3.0 protocolSi
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