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)