FileEncryptionStatusA-Funktion (winbase.h)

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 den Verschlüsselungsstatus der Datei empfängt. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
FILE_ENCRYPTABLE 0	Die Datei kann verschlüsselt werden. Home-, Home Premium-, Starter- und ARM-Editionen von Windows: FILE_ENCRYPTABLE können zurückgegeben werden, 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	Der Verschlüsselungsstatus ist unbekannt. Die Datei kann verschlüsselt werden.
FILE_USER_DISALLOWED 7	Reserviert für die zukünftige Verwendung.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

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

Technologie	Abgestützt
Server Message Block (SMB) 3.0-Protokoll	Ja
SMB 3.0 Transparent Failover (TFO)	Nein
SMB 3.0 mit Skalierungsdateifreigaben (SO)	Nein
Freigegebenes Clustervolumedateisystem (CsvFS)	Nein
Resilient File System (ReFS)	Nein

 

SMB 3.0 unterstützt EFS für Freigaben mit fortlaufender Verfügbarkeitsfunktion nicht.

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows XP Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winbase.h (enthalten Windows.h)
Library	Advapi32.lib
DLL-	Advapi32.dll

Siehe auch

EncryptFile-

Dateiverschlüsselung

Dateiverwaltungsfunktionen