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 Anrufer muss über die FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTESund SYNCHRONIZE Zugriffsrechte verfügen. Weitere Informationen finden Sie unter Dateisicherheits- und Zugriffsberechtigungen.
dwReserved
Reserviert; muss null sein.
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
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 Wert ungleich Null zurück, der den Erfolg angibt.
Wenn lpFileName- eine schreibgeschützte Datei angibt, schlägt die Funktion fehl und GetLastError gibt ERROR_FILE_READ_ONLYzurück. Wenn lpFileName ein Verzeichnis angibt, das eine schreibgeschützte Datei enthält, ist die Funktion erfolgreich, das Verzeichnis wird jedoch nicht entschlüsselt.
In Windows 8, Windows Server 2012 und höher 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 DecryptFile als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 [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 |
| API-Satz | ext-ms-win-advapi32-encryptedfile-l1-1-0 (eingeführt in Windows 8) |