Funzione EncryptionDisable (winefs.h)
Disabilita o abilita la crittografia della directory specificata e dei file in esso contenuti. Non influisce sulla crittografia delle sottodirectory sotto la directory indicata.
Sintassi
BOOL EncryptionDisable(
[in] LPCWSTR DirPath,
[in] BOOL Disable
);
Parametri
[in] DirPath
Nome della directory per cui abilitare o disabilitare la crittografia.
[in] Disable
Indica se disabilitare la crittografia (TRUE) o abilitarla (FALSE).
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 circostanze normali , EncryptFile non crittograferà file e directory con il set di attributi FILE_ATTRIBUTE_SYSTEM . È possibile eseguire l'override dell'attributo FILE_ATTRIBUTE_SYSTEM e crittografare i file. Inoltre, se un file o una directory è contrassegnato con l'attributo FILE_ATTRIBUTE_SYSTEM , in genere sarà invisibile all'utente nelle liste di directory e nelle finestre delle directory di Esplora risorse. EncryptionDisable disabilita la crittografia di directory e file. Non influisce sulla visibilità dei file con il set di attributi FILE_ATTRIBUTE_SYSTEM .
Se true viene passato, EncryptionDisable scriverà quanto segue nel file Desktop.ini nella directory (se necessario):
[Encryption]
Disable=1
Se la sezione esiste già ma Disable è impostata su 0, verrà impostata su 1.
Successivamente, EncryptFile avrà esito negativo nella directory e i file in esso contenuti e il codice restituito da GetLastError sarà ERROR_DIR_EFS_DISALLOWED. Questa funzione non influisce sulla crittografia delle sottodirectory all'interno della directory specificata.
L'utente può anche aggiungere o modificare manualmente le righe precedenti nel file Desktop.ini e produrre lo stesso effetto.
EncryptionDisable influisce solo su FileEncryptionStatus e EncryptFile. Dopo aver crittografato la directory, tutti i nuovi file e le nuove sottodirectory create senza l'attributo FILE_ATTRIBUTE_SYSTEM verranno crittografati.
Se FALSE viene passato, EncryptionDisable scriverà quanto segue nel file Desktop.ini:
[Encryption]
Disable=0
Ciò significa che la crittografia dei file è consentita nei file in tale directory.
Se si tenta di usare EncryptionDisable per impostare la directory sullo stato già presente, la funzione ha esito positivo ma non ha alcun effetto.
Se si tenta di usare EncryptionDisable per disabilitare o abilitare la crittografia in un file, il tentativo avrà esito negativo.
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.
Requisiti
| Client minimo supportato | Windows XP Professional [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winefs.h (include Windows.h) |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |