OpenEncryptedFileRawA-Funktion (winbase.h)

Artikel
11/20/2024

Öffnet eine verschlüsselte Datei, um die Datei zu sichern (exportieren) oder wiederherzustellen (importieren). Dies ist eine Gruppe von FUNKTIONEN des verschlüsselten Dateisystems (Encrypted File System, EFS), die für die Implementierung von Sicherungs- und Wiederherstellungsfunktionen vorgesehen sind, während Dateien in ihrem verschlüsselten Zustand beibehalten werden.

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 auszuführende Vorgang. 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 (Wiederherstellen) geöffnet.
CREATE_FOR_DIR 2	Importieren (Wiederherstellen) eines Verzeichnisses, das verschlüsselte Dateien enthält. Dies muss mit einer der beiden vorherigen Flags kombiniert werden, um den Vorgang anzugeben.
OVERWRITE_HIDDEN 4	Überschreiben Einer ausgeblendeten Datei beim Import.

[out] pvContext

Die Adresse eines Kontextblocks, der in nachfolgenden Aufrufen von ReadEncryptedFileRaw, WriteEncryptedFileRawoder CloseEncryptedFileRawangezeigt werden muss. Ändern Sie sie nicht.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESSzurückgegeben.

Wenn die Funktion fehlschlägt, wird ein nichtzero-Fehlercode zurückgegeben, der in WinError.h definiert ist. Sie können FormatMessage- mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine generische Textbeschreibung des Fehlers zu erhalten.

Bemerkungen

Der Aufrufer muss über Lese- oder Schreibzugriff auf die Datei verfügen oder über Sicherungsberechtigungen SeBackupPrivilege auf dem Computer verfügen, auf dem sich die Dateien befinden, damit der Aufruf erfolgreich ausgeführt werden kann.

Rufen Sie zum Sichern einer verschlüsselten Datei OpenEncryptedFileRaw auf, um die Datei zu öffnen, und rufen Sie dann ReadEncryptedFileRawauf. Wenn die Sicherung abgeschlossen ist, rufen Sie CloseEncryptedFileRawauf.

Rufen Sie zum Wiederherstellen einer verschlüsselten Datei OpenEncryptedFileRawauf, und geben Sie CREATE_FOR_IMPORT im ulFlags Parameter an, und rufen Sie dann einmal WriteEncryptedFileRaw auf. Rufen Sie nach Abschluss des Vorgangs CloseEncryptedFileRawauf.

OpenEncryptedFileRaw schlägt fehl, wenn lpFileNameMAX_PATH Zeichen überschreitet, wenn eine verschlüsselte Datei auf einem Remotecomputer geöffnet wird.

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

Die BackupRead und BackupWrite Funktionen verarbeiten 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	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 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
mindestens unterstützte Client-	Windows XP Professional [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)