ReadEncryptedFileRaw 函式 (winbase.h)

備份 (匯出) 加密檔案。 這是一組加密文件系統 (EFS) 函式，用來實作備份和還原功能，同時維持其加密狀態的檔案。

語法

DWORD ReadEncryptedFileRaw(
  [in]           PFE_EXPORT_FUNC pfExportCallback,
  [in, optional] PVOID           pvCallbackContext,
  [in]           PVOID           pvContext
);

參數

[in] pfExportCallback

匯出回呼函式的指標。 系統會多次呼叫回呼函式，每次將檔案數據的區塊傳遞至回呼函式，直到讀取整個檔案為止。 如需詳細資訊，請參閱 ExportCallback。

[in, optional] pvCallbackContext

應用程式定義的和已配置內容區塊的指標。 系統會將此指標傳遞至回呼函式做為參數，讓回呼函式可以存取應用程式特定的數據。 這可以是結構，而且可以包含應用程式所需的任何數據，例如將包含加密檔案備份複本之檔案的句柄。

[in] pvContext

系統定義內容區塊的指標。 內容區塊是由 OpenEncryptedFileRaw 函式傳回。 請勿修改該字串。

傳回值

如果函式成功，傳回值 會ERROR_SUCCESS。

如果函式失敗，它會傳回 WinError.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤的一般文字描述。

備註

正在備份的檔案不會解密;其已備份其加密狀態。

若要備份加密的檔案，請呼叫 OpenEncryptedFileRaw 來開啟檔案。 然後呼叫 ReadEncryptedFileRaw，並傳遞應用程式定義匯出回呼函式的位址。 系統會多次呼叫此回呼函式，直到整個檔案的內容已讀取和備份為止。 備份完成時，請呼叫 CloseEncryptedFileRaw 以釋放資源並關閉檔案。 如需如何宣告導出回呼函式的詳細資訊，請參閱 ExportCallback 。

若要還原加密的檔案，請呼叫 OpenEncryptedFileRaw，並在 ulFlags 參數中指定CREATE_FOR_IMPORT。 然後呼叫 WriteEncryptedFileRaw，並傳遞應用程式定義匯入回呼函式的位址。 系統會多次呼叫此回呼函式，直到整個檔案的內容已讀取和還原為止。 還原完成時，請呼叫 CloseEncryptedFileRaw 以釋放資源並關閉檔案。 如需如何宣告匯入回呼函式的詳細資訊，請參閱 ImportCallback 。

此函式僅適用於僅加密檔案的備份;請參閱 BackupRead 以備份未加密的檔案。

在 Windows 8、Windows Server 2012 及更新版本中，下列技術支援此函式。

SMB 3.0 不支援具有持續可用性功能的共用上的EFS。

規格需求

另請參閱

BackupRead

CloseEncryptedFileRaw

檔案加密

檔案管理功能

OpenEncryptedFileRaw

WriteEncryptedFileRaw