Funzione FileEncryptionStatusA (winbase.h)

  • Articolo

Recupera lo stato di crittografia del file specificato.

Sintassi

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

Parametri

[in] lpFileName

Nome del file.

[out] lpStatus

Puntatore a una variabile che riceve lo stato di crittografia del file. Questo parametro può avere uno dei valori seguenti.

Valore Significato
FILE_ENCRYPTABLE
0
 Il file può essere crittografato.

Home, Home Premium, Starter e Arm Edition di Windows: FILE_ENCRYPTABLE può essere restituito, ma EFS non supporta la crittografia dei file in queste edizioni di Windows.
FILE_IS_ENCRYPTED
1
 Il file viene crittografato.
FILE_READ_ONLY
8
 Il file è un file di sola lettura.
FILE_ROOT_DIR
3
 Il file è una directory radice. Non è possibile crittografare le directory radice.
FILE_SYSTEM_ATTR
2
 Il file è un file system. I file di sistema non possono essere crittografati.
FILE_SYSTEM_DIR
4
 Il file è una directory di sistema. Non è possibile crittografare le directory di sistema.
FILE_SYSTEM_NOT_SUPPORT
6
 Il file system non supporta la crittografia dei file.
FILE_UNKNOWN
5
 Lo stato di crittografia è sconosciuto. Il file può essere crittografato.
FILE_USER_DISALLOWED
7
 Riservato per utilizzi futuri.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 Sì
Failover trasparente SMB 3.0 (TFO) No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) No
File system del volume condiviso del cluster (CsvFS) No
File system resiliente (ReFS) No
 

SMB 3.0 non supporta EFS nelle condivisioni con funzionalità di disponibilità continua.

Nota

L'intestazione winbase.h definisce FileEncryptionStatus come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP Professional [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

EncryptFile

Crittografia file

Funzioni di gestione file