QueryRecoveryAgentsOnEncryptedFile 函式 (winefs.h)

  • 發行項

擷取指定檔案的復原代理程式清單。

語法

DWORD QueryRecoveryAgentsOnEncryptedFile(
  [in]  LPCWSTR                           lpFileName,
  [out] PENCRYPTION_CERTIFICATE_HASH_LIST *pRecoveryAgents
);

參數

[in] lpFileName

檔案的名稱。

[out] pRecoveryAgents

接收復原代理程式清單 之ENCRYPTION_CERTIFICATE_HASH_LIST 結構的指標。

傳回值

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

如果函式失敗，則傳回值是系統錯誤碼。 如需錯誤碼的完整清單，請參閱 系統錯誤碼 或頭檔 WinError.h。

備註

當不再需要復原代理程序清單時，請呼叫 FreeEncryptionCertificateHashList 函式來釋放它。

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

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 Yes
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) No
彈性檔案系統 (ReFS) No
 

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

規格需求

需求 值
最低支援的用戶端 Windows XP Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winefs.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll
API 集合 ext-ms-win-advapi32-encryptedfile-l1-1-1 (於 Windows 10 10.0.14393 版)

另請參閱

ENCRYPTION_CERTIFICATE_HASH_LIST

檔案加密

檔案管理功能

FreeEncryptionCertificateHashList