Funzione FileEncryptionStatusW (winbase.h)

  • Articolo

Recupera lo stato di crittografia del file specificato.

Sintassi

BOOL FileEncryptionStatusW(
  [in]  LPCWSTR 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 è crittografato.
FILE_READ_ONLY
8
 Il file è un file di sola lettura.
FILE_ROOT_DIR
3
 Il file è una directory radice. Le directory radice non possono essere crittografate.
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. Le directory di sistema non possono essere crittografate.
FILE_SYSTEM_NOT_SUPPORT
6
 Il file system non supporta la crittografia dei file.
FILE_UNKNOWN
5
 Lo stato della 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 di scalabilità orizzontale (SO) No
File system del volume condiviso cluster (CsvFS) No
Resilient File System (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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

   
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