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 协议 是
SMB 3.0 透明故障转移 (TFO) 否
具有横向扩展文件共享的 SMB 3.0 (SO) 否
群集共享卷文件系统 (CSV) 否
弹性文件系统 (ReFS) 否
 

SMB 3.0 不支持具有连续可用性功能的共享上的 EFS。

要求

要求 值
最低受支持的客户端 Windows XP Professional [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winefs.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll
API 集 ext-ms-win-advapi32-encryptedfile-l1-1-1 (在 Windows 10 版本 10.0.14393 中引入)

另请参阅

ENCRYPTION_CERTIFICATE_HASH_LIST

文件加密

文件管理函数

FreeEncryptionCertificateHashList