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) |