WriteEncryptedFileRaw-Funktion (winbase.h)

Artikel
08/27/2023

Stellt verschlüsselte Dateien wieder her (Import). Dies ist eine Gruppe von EFS-Funktionen (Encrypted File System), die sicherungs- und wiederherstellungsfunktionen implementieren und gleichzeitig Dateien im verschlüsselten Zustand beibehalten.

Syntax

DWORD WriteEncryptedFileRaw(
  [in]           PFE_IMPORT_FUNC pfImportCallback,
  [in, optional] PVOID           pvCallbackContext,
  [in]           PVOID           pvContext
);

Parameter

[in] pfImportCallback

Ein Zeiger auf die Importrückruffunktion. Das System ruft die Rückruffunktion mehrmals auf, wobei jedes Mal ein Puffer übergeben wird, der von der Rückruffunktion mit einem Teil der Daten der gesicherten Datei gefüllt wird. Wenn die Rückruffunktion signalisiert, dass die gesamte Datei verarbeitet wurde, teilt sie dem System mit, dass der Wiederherstellungsvorgang abgeschlossen ist. Weitere Informationen finden Sie unter ImportCallback.

[in, optional] pvCallbackContext

Ein Zeiger auf einen anwendungsdefinierten und zugeordneten Kontextblock. Das System übergibt diesen Zeiger als Parameter an die Rückruffunktion, sodass die Rückruffunktion Zugriff auf anwendungsspezifische Daten haben kann. Dies kann eine Struktur sein und alle von der Anwendung benötigten Daten enthalten, z. B. das Handle für die Datei, die die Sicherungskopie der verschlüsselten Datei enthält.

[in] pvContext

Ein Zeiger auf einen systemdefinierten Kontextblock. Der Kontextblock wird von der OpenEncryptedFileRaw-Funktion zurückgegeben. Ändern Sie sie nicht.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, gibt sie einen nichtzero-Fehlercode zurück, der in WinError.h definiert ist. Sie können FormatMessage mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine allgemeine Textbeschreibung des Fehlers abzurufen.

Hinweise

Die wiederhergestellte Datei wird nicht entschlüsselt. es wird im verschlüsselten Zustand wiederhergestellt.

Um eine verschlüsselte Datei zu sichern, rufen Sie OpenEncryptedFileRaw auf, um die Datei zu öffnen. Rufen Sie dann ReadEncryptedFileRaw auf, und übergeben Sie ihr die Adresse einer anwendungsdefinierten Exportrückruffunktion. Das System ruft diese Rückruffunktion mehrmals auf, bis der gesamte Inhalt der Datei gelesen und gesichert wurde. Wenn die Sicherung abgeschlossen ist, rufen Sie CloseEncryptedFileRaw auf, um Ressourcen freizugeben und die Datei zu schließen. Weitere Informationen zum Deklarieren der Exportrückruffunktion finden Sie unter ExportCallback .

Um eine verschlüsselte Datei wiederherzustellen, rufen Sie OpenEncryptedFileRaw auf, und geben Sie CREATE_FOR_IMPORT im ulFlags-Parameter an. Rufen Sie dann WriteEncryptedFileRaw auf, und übergeben Sie ihr die Adresse einer anwendungsdefinierten Importrückruffunktion. Das System ruft diese Rückruffunktion mehrmals auf, bis der gesamte Inhalt der Datei gelesen und wiederhergestellt wurde. Wenn die Wiederherstellung abgeschlossen ist, rufen Sie CloseEncryptedFileRaw auf, um Ressourcen freizugeben und die Datei zu schließen. Weitere Informationen zum Deklarieren der Exportrückruffunktion finden Sie unter ImportCallback .

Wenn es sich bei der Datei um eine Sparsedatei handelt, die von einem Volume mit einer geringeren Größe der Sparse-Zuordnungseinheiten als dem Volume, in dem sie wiederhergestellt wird, gesichert wurde, sind die Sparseblöcke in der Mitte der Datei möglicherweise nicht ordnungsgemäß mit den größeren Blöcken ausgerichtet, und der Funktionsaufruf schlägt fehl und legt einen ERROR_INVALID_PARAMETER letzten Fehlercode fest. Die Größe der Sparsezuordnungseinheiten beträgt entweder 16 Cluster oder 64 KB, je nachdem, welcher Wert kleiner ist.

Diese Funktion ist nur für die Wiederherstellung verschlüsselter Dateien vorgesehen. Informationen zum Wiederherstellen unverschlüsselter Dateien finden Sie unter BackupWrite .

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.

Anforderungen


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 (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll
APIs	ext-ms-win-advapi32-encryptedfile-l1-1-0 (in Windows 8 eingeführt)