Funzione FileEncryptionStatusA (winbase.h)

Articolo
11/20/2024

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ò essere uno dei valori seguenti.

Valore	Significato
FILE_ENCRYPTABLE 0	Il file può essere crittografato. edizioni Home, Home Premium, Starter e ARM di Windows: FILE_ENCRYPTABLE possono essere restituite, 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 di sistema. 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 uso futuro.

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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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

Tecnologia	Sostenuto
Protocollo SMB (Server Message Block) 3.0	Sì
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	No
Cluster Shared Volume File System (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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP Professional [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

EncryptFile

di crittografia file

funzioni di gestione file

Condividi tramite