Função RemoveUsersFromEncryptedFile (winefs.h)

Remove hashes de certificado especificados de um arquivo especificado.

Sintaxe

DWORD RemoveUsersFromEncryptedFile(
  [in] LPCWSTR                           lpFileName,
  [in] PENCRYPTION_CERTIFICATE_HASH_LIST pHashes
);

Parâmetros

[in] lpFileName

O nome do arquivo.

[in] pHashes

Um ponteiro para uma estrutura ENCRYPTION_CERTIFICATE_HASH_LIST que contém uma lista de hashes de certificado a serem removidos do arquivo.

Retornar valor

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

Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista completa de códigos de erro, consulte Códigos de erro do sistema ou o arquivo de cabeçalho WinError.h.

Comentários

A função RemoveUsersFromEncryptedFile remove os hashes de certificado especificados se eles existirem no arquivo especificado. Se qualquer um dos hashes de certificado não for encontrado no arquivo especificado, eles serão ignorados e nenhum código de erro será retornado.

Começando com 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 No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) No
ReFS (Sistema de Arquivos Resiliente) No
 

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winefs.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll
Conjunto de APIs ext-ms-win-advapi32-encryptedfile-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)

Confira também

ENCRYPTION_CERTIFICATE_HASH_LIST

Criptografia de Arquivo

Funções de gerenciamento de arquivos