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)

Vedi anche

CreateFile

EncryptFile

Crittografia file

Funzioni di gestione file