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 de ENCRYPTION_CERTIFICATE_LIST que contiene la lista de claves de usuario nuevas que se van a agregar al 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

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	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 capacidad de disponibilidad continua.

Ejemplos

Para obtener código de ejemplo que usa esta función, vea Agregar usuarios a un archivo cifrado.

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)

Consulte también

ENCRYPTION_CERTIFICATE_LIST

Cifrado de archivos

Funciones de administración de archivos