Função FileEncryptionStatusW (winbase.h)

Artigo
11/20/2024

Recupera o status de criptografia do arquivo especificado.

Sintaxe

BOOL FileEncryptionStatusW(
  [in]  LPCWSTR lpFileName,
  [out] LPDWORD lpStatus
);

Parâmetros

[in] lpFileName

O nome do arquivo.

[out] lpStatus

Um ponteiro para uma variável que recebe o status de criptografia do arquivo. Esse parâmetro pode ser um dos valores a seguir.

Valor	Significado
FILE_ENCRYPTABLE 0	O arquivo pode ser criptografado. Home, Home Premium, Starter e ARM Editions do Windows: FILE_ENCRYPTABLE podem ser retornados, mas o EFS não dá suporte à criptografia de arquivos nessas edições do Windows.
FILE_IS_ENCRYPTED 1	O arquivo é criptografado.
FILE_READ_ONLY 8	O arquivo é um arquivo somente leitura.
FILE_ROOT_DIR 3	O arquivo é um diretório raiz. Os diretórios raiz não podem ser criptografados.
FILE_SYSTEM_ATTR 2	O arquivo é um arquivo do sistema. Os arquivos do sistema não podem ser criptografados.
FILE_SYSTEM_DIR 4	O arquivo é um diretório do sistema. Os diretórios do sistema não podem ser criptografados.
FILE_SYSTEM_NOT_SUPPORT 6	O sistema de arquivos não dá suporte à criptografia de arquivo.
FILE_UNKNOWN 5	O status de criptografia é desconhecido. O arquivo pode ser criptografado.
FILE_USER_DISALLOWED 7	Reservado para uso futuro.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

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

Tecnologia	Suportado
Protocolo SMB (Bloco de Mensagens do Servidor) 3.0	Sim
TFO (Failover Transparente) do SMB 3.0	Não
SMB 3.0 com Compartilhamentos de Arquivos de Expansão (SO)	Não
Sistema de Arquivos de Volume Compartilhado de Cluster (CsvFS)	Não
ReFS (Sistema de Arquivos Resiliente)	Não

O SMB 3.0 não dá suporte ao EFS em compartilhamentos com capacidade de disponibilidade contínua.

Nota

O cabeçalho winbase.h define FileEncryptionStatus como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winbase.h (inclua Windows.h)
biblioteca	Advapi32.lib
de DLL	Advapi32.dll

Consulte também

EncryptFile

de Criptografia de Arquivo

Funções de gerenciamento de arquivos

Compartilhar via