Función RemoveUsersFromEncryptedFile (winefs.h)
Quita los valores hash de certificado especificados de un archivo especificado.
Sintaxis
DWORD RemoveUsersFromEncryptedFile(
[in] LPCWSTR lpFileName,
[in] PENCRYPTION_CERTIFICATE_HASH_LIST pHashes
);
Parámetros
[in] lpFileName
Nombre del archivo.
[in] pHashes
Puntero a una estructura de ENCRYPTION_CERTIFICATE_HASH_LIST que contiene una lista de hashes de certificado que se van a quitar del archivo.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.
Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista completa de los códigos de error, consulta Códigos de error del sistema o el archivo de encabezado WinError.h.
Comentarios
La función RemoveUsersFromEncryptedFile quita los hashes de certificado especificados si existen en el archivo especificado. Si alguno de los hashes de certificado no se encuentra en el archivo especificado, se omiten y no se devuelve ningún código de error.
A partir de Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.
| Tecnología | Compatible |
|---|---|
| Protocolo Bloque de mensajes del servidor (SMB) 3.0 | Sí |
| Conmutación por error transparente (TFO) de SMB 3.0 | No |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | No |
| Sistema de archivos de Volumen compartido de clúster (CsvFS) | No |
| Sistema de archivos resistente a errores (ReFS) | No |
SMB 3.0 no admite EFS en recursos compartidos con capacidad de disponibilidad continua.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winefs.h (incluye Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |
| Conjunto de API | ext-ms-win-advapi32-encryptedfile-l1-1-1 (introducido en Windows 10, versión 10.0.14393) |