Función AddUsersToEncryptedFile (winefs.h)
Agrega claves de usuario al archivo cifrado especificado.
Sintaxis
DWORD AddUsersToEncryptedFile(
[in] LPCWSTR lpFileName,
[in] PENCRYPTION_CERTIFICATE_LIST pEncryptionCertificates
);
Parámetros
[in] lpFileName
Nombre del archivo cifrado.
[in] pEncryptionCertificates
Puntero a una estructura ENCRYPTION_CERTIFICATE_LIST que contiene la lista de nuevas claves de usuario que se van a agregar al archivo.
Valor devuelto
Si la función se realiza correctamente, se ERROR_SUCCESS el valor devuelto.
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
A partir de Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.
| Technology | Compatible |
|---|---|
| Protocolo bloque de mensajes del servidor (SMB) 3.0 | No |
| 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 funcionalidad de disponibilidad continua.
Ejemplos
Para obtener código de ejemplo que usa esta función, vea Agregar usuarios a un archivo cifrado.
Requisitos
| 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) |