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) |