ReadEncryptedFileRaw-Funktion (winbase.h)

Artikel
08/27/2023

Sichert verschlüsselte Dateien (Export). 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 ReadEncryptedFileRaw(
  [in]           PFE_EXPORT_FUNC pfExportCallback,
  [in, optional] PVOID           pvCallbackContext,
  [in]           PVOID           pvContext
);

Parameter

[in] pfExportCallback

Ein Zeiger auf die Exportrückruffunktion. Das System ruft die Rückruffunktion mehrmals auf, wobei jedes Mal ein Block der Daten der Datei an die Rückruffunktion übergeben wird, bis die gesamte Datei gelesen wurde. Weitere Informationen finden Sie unter ExportCallback.

[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 zu sichernde Datei wird nicht entschlüsselt. es wird im verschlüsselten Zustand gesichert.

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 Importrückruffunktion finden Sie unter ImportCallback .

Diese Funktion ist nur für die Sicherung von verschlüsselten Dateien vorgesehen. Informationen zur Sicherung unverschlüsselter Dateien finden Sie unter BackupRead .

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

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