Compartir a través de

Función FileEncryptionStatusA (winbase.h)

  • Artículo

Recupera el estado de cifrado del archivo especificado.

Sintaxis

BOOL FileEncryptionStatusA(
  [in]  LPCSTR  lpFileName,
  [out] LPDWORD lpStatus
);

Parámetros

[in] lpFileName

Nombre del archivo.

[out] lpStatus

Puntero a una variable que recibe el estado de cifrado del archivo. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
FILE_ENCRYPTABLE
0
 El archivo se puede cifrar.

Home, Home Premium, Starter y ARM Ediciones de Windows: se puede devolver FILE_ENCRYPTABLE, pero EFS no admite el cifrado de archivos en estas ediciones de Windows.
FILE_IS_ENCRYPTED
1
 El archivo está cifrado.
FILE_READ_ONLY
8
 El archivo es un archivo de solo lectura.
FILE_ROOT_DIR
3
 El archivo es un directorio raíz. Los directorios raíz no se pueden cifrar.
FILE_SYSTEM_ATTR
2
 El archivo es un archivo de sistema. Los archivos del sistema no se pueden cifrar.
FILE_SYSTEM_DIR
4
 El archivo es un directorio del sistema. Los directorios del sistema no se pueden cifrar.
FILE_SYSTEM_NOT_SUPPORT
6
 El sistema de archivos no admite el cifrado de archivos.
FILE_UNKNOWN
5
 El estado de cifrado es desconocido. El archivo se puede cifrar.
FILE_USER_DISALLOWED
7
 Reservado para uso futuro.

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

Nota

El encabezado winbase.h define FileEncryptionStatus como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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 winbase.h (incluya Windows.h)
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

EncryptFile

Cifrado de archivos

Funciones de administración de archivos