DecryptFileA-Funktion (winbase.h)

Entschlüsselt eine verschlüsselte Datei oder ein verschlüsseltes Verzeichnis.

Syntax

BOOL DecryptFileA(
  [in] LPCSTR lpFileName,
       DWORD  dwReserved
);

Parameter

[in] lpFileName

Der Name der zu entschlüsselnden Datei oder des Verzeichnisses.

Der Aufrufer muss über die Zugriffsrechte FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES und SYNCHRONIZE verfügen. Weitere Informationen finden Sie unter Dateisicherheit und Zugriffsrechte.

dwReserved

Reserviert; muss null sein.

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

Die DecryptFile-Funktion erfordert exklusiven Zugriff auf die zu entschlüsselnde Datei und schlägt fehl, wenn ein anderer Prozess die Datei verwendet. Wenn die Datei nicht verschlüsselt ist, gibt DecryptFile einfach einen Nonzero-Wert zurück, der den Erfolg anzeigt.

Wenn lpFileName eine schreibgeschützte Datei angibt, schlägt die Funktion fehl, und GetLastError gibt ERROR_FILE_READ_ONLY zurück. Wenn lpFileName ein Verzeichnis angibt, das eine schreibgeschützte Datei enthält, sind die Funktionen erfolgreich, aber das Verzeichnis wird nicht entschlüsselt.

In Windows 8, Windows Server 2012 und höher 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 DecryptFile 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

Unterstützte Mindestversion (Client)	Windows XP [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
APIs	ext-ms-win-advapi32-encryptedfile-l1-1-0 (in Windows 8 eingeführt)

Weitere Informationen

CreateFile

EncryptFile

Dateiverschlüsselung

Dateiverwaltungsfunktionen