Función EncryptionDisable (winefs.h)

Artículo
08/27/2023

Deshabilita o habilita el cifrado del directorio especificado y los archivos que contiene. No afecta al cifrado de subdirectorios por debajo del directorio indicado.

Sintaxis

BOOL EncryptionDisable(
  [in] LPCWSTR DirPath,
  [in] BOOL    Disable
);

Parámetros

[in] DirPath

Nombre del directorio para el que se va a habilitar o deshabilitar el cifrado.

[in] Disable

Indica si se debe deshabilitar el cifrado (TRUE) o habilitarlo (FALSE).

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

En circunstancias normales, EncryptFile no cifrará archivos ni directorios con el FILE_ATTRIBUTE_SYSTEM conjunto de atributos. Es posible invalidar el atributo FILE_ATTRIBUTE_SYSTEM y cifrar archivos. Además, si un archivo o directorio está marcado con el atributo FILE_ATTRIBUTE_SYSTEM , normalmente será invisible para el usuario en listas de directorios y ventanas de directorio del Explorador de Windows. EncryptionDisable deshabilita el cifrado de directorios y archivos. No afecta a la visibilidad de los archivos con el conjunto de atributos FILE_ATTRIBUTE_SYSTEM .

Si se pasa TRUE , EncryptionDisable escribirá lo siguiente en el archivo Desktop.ini en el directorio (lo creará si es necesario):

[Encryption]
Disable=1

Si la sección ya existe, pero Disable está establecida en 0, se establecerá en 1.

A partir de entonces, EncryptFile producirá un error en el directorio y en los archivos, y el código que devuelve GetLastError será ERROR_DIR_EFS_DISALLOWED. Esta función no afecta al cifrado de subdirectorios dentro del directorio especificado.

El usuario también puede agregar o editar manualmente las líneas anteriores en el archivo Desktop.ini y producir el mismo efecto.

EncryptionDisable solo afecta a FileEncryptionStatus y EncryptFile. Una vez cifrado el directorio, se cifrarán los nuevos archivos y los subdirectorios nuevos creados sin el atributo FILE_ATTRIBUTE_SYSTEM .

Si se pasa FALSE , EncryptionDisable escribirá lo siguiente en el archivo Desktop.ini:

[Encryption]
Disable=0

Esto significa que se permite el cifrado de archivos en los archivos de ese directorio.

Si intenta usar EncryptionDisable para establecer el directorio en el estado en el que ya está, la función se realiza correctamente pero no tiene ningún efecto.

Si intenta usar EncryptionDisable para deshabilitar o habilitar el cifrado en un archivo, se producirá un error en el intento.

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

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


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