Funzione DecryptFileA (winbase.h)
Decrittografa un file o una directory crittografata.
Sintassi
BOOL DecryptFileA(
[in] LPCSTR lpFileName,
DWORD dwReserved
);
Parametri
[in] lpFileName
Nome del file o della directory da decrittografare.
Il chiamante deve disporre dei diritti di accesso FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES e SYNCHRONIZE . Per altre informazioni, vedere Protezione dei file e diritti di accesso.
dwReserved
Riservati; deve essere zero.
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
La funzione DecryptFile richiede l'accesso esclusivo al file decrittografato e avrà esito negativo se un altro processo usa il file. Se il file non è crittografato, DecryptFile restituisce semplicemente un valore diverso da zero, che indica l'esito positivo.
Se lpFileName specifica un file di sola lettura, la funzione ha esito negativo e GetLastError restituisce ERROR_FILE_READ_ONLY. Se lpFileName specifica una directory che contiene un file di sola lettura, le funzioni hanno esito positivo, ma la directory non viene decrittografata.
In Windows 8, Windows Server 2012 e versioni successive 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 DecryptFile 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 [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 |
| Set di API | ext-ms-win-advapi32-encryptedfile-l1-1-0 (introdotto in Windows 8) |