OpenEncryptedFileRawA-Funktion (winbase.h)

Artikel
08/27/2023

Öffnet eine verschlüsselte Datei, um die Datei zu sichern (Export) oder wiederherzustellen (Import). Dies ist eine Gruppe von EFS-Funktionen (Encrypted File System), die Sicherungs- und Wiederherstellungsfunktionen implementieren und gleichzeitig Dateien im verschlüsselten Zustand beibehalten soll.

Syntax

DWORD OpenEncryptedFileRawA(
  [in]  LPCSTR lpFileName,
  [in]  ULONG  ulFlags,
  [out] PVOID  *pvContext
);

Parameter

[in] lpFileName

Der Name der zu öffnenden Datei. Die Zeichenfolge muss aus Zeichen aus dem Windows-Zeichensatz bestehen.

[in] ulFlags

Der Vorgang, der ausgeführt werden soll. Dieser Parameter kann einer der folgenden Werte sein.

Wert	Bedeutung
0	Öffnen Sie die Datei für den Export (Sicherung).
CREATE_FOR_IMPORT 1	Die Datei wird für den Import (Wiederherstellung) geöffnet.
CREATE_FOR_DIR 2	Importieren (Wiederherstellen) eines Verzeichnisses, das verschlüsselte Dateien enthält. Dies muss mit einem der beiden vorherigen Flags kombiniert werden, um den Vorgang anzugeben.
OVERWRITE_HIDDEN 4	Überschreiben Sie eine ausgeblendete Datei beim Import.

[out] pvContext

Die Adresse eines Kontextblocks, der in nachfolgenden Aufrufen von ReadEncryptedFileRaw, WriteEncryptedFileRaw oder CloseEncryptedFileRaw angezeigt werden muss. Ändern Sie sie nicht.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, gibt sie einen in WinError.h definierten Fehlercode ungleich null zurück. Sie können FormatMessage mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Textbeschreibung des Fehlers abzurufen.

Hinweise

Der Aufrufer muss entweder Über Lese- oder Schreibzugriff auf die Datei verfügen, oder er muss über die Sicherungsberechtigung SeBackupPrivilege auf dem Computer verfügen, auf dem sich die Dateien befinden, damit der Aufruf erfolgreich ist.

Um eine verschlüsselte Datei zu sichern, rufen Sie OpenEncryptedFileRaw auf, um die Datei zu öffnen, und rufen Sie dann ReadEncryptedFileRaw auf. Wenn die Sicherung abgeschlossen ist, rufen Sie CloseEncryptedFileRaw auf.

Um eine verschlüsselte Datei wiederherzustellen, rufen Sie OpenEncryptedFileRaw auf, geben Sie CREATE_FOR_IMPORT im ulFlags-Parameter an, und rufen Sie dann einmal WriteEncryptedFileRaw auf. Wenn der Vorgang abgeschlossen ist, rufen Sie CloseEncryptedFileRaw auf.

OpenEncryptedFileRaw schlägt fehl, wenn lpFileName beim Öffnen einer verschlüsselten Datei auf einem Remotecomputer MAX_PATH Zeichen überschreitet.

Wenn der Aufrufer keinen Zugriff auf den Schlüssel für die Datei hat, benötigt der Aufrufer SeBackupPrivilege, um verschlüsselte Dateien zu exportieren, oder SeRestorePrivilege, um verschlüsselte Dateien zu importieren.

Die Funktionen BackupRead und BackupWrite behandeln die Sicherung und Wiederherstellung unverschlüsselter Dateien.

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 OpenEncryptedFileRaw 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
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
APIs	ext-ms-win-advapi32-encryptedfile-l1-1-0 (eingeführt in Windows 8)