FileEncryptionStatusA-Funktion (winbase.h)

Artikel
03/03/2024

Ruft den Verschlüsselungsstatus der angegebenen Datei ab.

Syntax

BOOL FileEncryptionStatusA(
  [in]  LPCSTR  lpFileName,
  [out] LPDWORD lpStatus
);

Parameter

[in] lpFileName

Der Name der Datei.

[out] lpStatus

Ein Zeiger auf eine Variable, die die Verschlüsselung status der Datei empfängt. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
FILE_ENCRYPTABLE 0	Die Datei kann verschlüsselt werden. Home, Home Premium, Starter und ARM Edition von Windows: FILE_ENCRYPTABLE werden möglicherweise zurückgegeben, aber EFS unterstützt die Verschlüsselung von Dateien in diesen Editionen von Windows nicht.
FILE_IS_ENCRYPTED 1	Die Datei ist verschlüsselt.
FILE_READ_ONLY 8	Die Datei ist eine schreibgeschützte Datei.
FILE_ROOT_DIR 3	Die Datei ist ein Stammverzeichnis. Stammverzeichnisse können nicht verschlüsselt werden.
FILE_SYSTEM_ATTR 2	Die Datei ist eine Systemdatei. Systemdateien können nicht verschlüsselt werden.
FILE_SYSTEM_DIR 4	Die Datei ist ein Systemverzeichnis. Systemverzeichnisse können nicht verschlüsselt werden.
FILE_SYSTEM_NOT_SUPPORT 6	Das Dateisystem unterstützt keine Dateiverschlüsselung.
FILE_UNKNOWN 5	Die Verschlüsselung status ist unbekannt. Die Datei kann verschlüsselt sein.
FILE_USER_DISALLOWED 7	Für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	No
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	No
Robustes Dateisystem (Resilient File System, ReFS)	No

SMB 3.0 unterstützt EFS für Freigaben mit Continuous Availability-Funktion nicht.

Hinweis

Der winbase.h-Header definiert FileEncryptionStatus als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

EncryptFile

Dateiverschlüsselung

Dateiverwaltungsfunktionen

Freigeben über