Função GetFileType (fileapi.h)

  • Artigo

Recupera o tipo do arquivo especificado.

Sintaxe

DWORD GetFileType(
  [in] HANDLE hFile
);

Parâmetros

[in] hFile

Um manipulador para o arquivo.

Retornar valor

A função retorna um dos valores a seguir.

Valor/código retornado Descrição
FILE_TYPE_CHAR
0x0002
 O arquivo especificado é um arquivo de caracteres, normalmente um dispositivo LPT ou um console.
FILE_TYPE_DISK
0x0001
 O arquivo especificado é um arquivo de disco.
FILE_TYPE_PIPE
0x0003
 O arquivo especificado é um soquete, um pipe nomeado ou um pipe anônimo.
FILE_TYPE_REMOTE
0x8000
 Não utilizado.
FILE_TYPE_UNKNOWN
0x0000
 O tipo do arquivo especificado é desconhecido ou a função falhou.
 

Você pode distinguir entre um retorno "válido" de FILE_TYPE_UNKNOWN e seu retorno devido a um erro de chamada (por exemplo, passando um identificador inválido para GetFileType) chamando GetLastError.

Se a função funcionou corretamente e FILE_TYPE_UNKNOWN foi retornado, uma chamada para GetLastError retornará NO_ERROR.

Se a função retornada FILE_TYPE_UNKNOWN devido a um erro ao chamar GetFileType, GetLastError retornará o código de erro.

Comentários

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 Sim
TFO (Failover transparente) do SMB 3.0 Sim
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) Sim
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho fileapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de gerenciamento de arquivos

GetFileSize

GetFileTime