Função GetFileType (fileapi.h)
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 |
|---|---|
|
O arquivo especificado é um arquivo de caracteres, normalmente um dispositivo LPT ou um console. |
|
O arquivo especificado é um arquivo de disco. |
|
O arquivo especificado é um soquete, um pipe nomeado ou um pipe anônimo. |
|
Não utilizado. |
|
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 |