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

Valor Significado
FILE_ENCRYPTABLE
0
 El archivo se puede cifrar.

las ediciones Home, Home Premium, Starter y ARM de Windows: FILE_ENCRYPTABLE se pueden devolver, 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 del 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 ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

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

Tecnología Soportado
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 (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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winbase.h (incluya Windows.h)
biblioteca de Advapi32.lib
DLL de Advapi32.dll

Consulte también

encryptFile de

de cifrado de archivos de

funciones de administración de archivos