FileEncryptionStatusW-Funktion (winbase.h)

  • Artikel

Ruft den Verschlüsselungsstatus der angegebenen Datei ab.

Syntax

BOOL FileEncryptionStatusW(
  [in]  LPCWSTR 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 Editionen von Windows: FILE_ENCRYPTABLE werden möglicherweise zurückgegeben, aber EFS unterstützt das Verschlüsseln 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üsselungs 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 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

   
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 (Windows.h einschließen)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

EncryptFile

Dateiverschlüsselung

Dateiverwaltungsfunktionen