RemoveUsersFromEncryptedFile 函数 (winefs.h)

从指定的文件中删除指定的证书哈希。

语法

DWORD RemoveUsersFromEncryptedFile(
  [in] LPCWSTR                           lpFileName,
  [in] PENCRYPTION_CERTIFICATE_HASH_LIST pHashes
);

参数

[in] lpFileName

文件的名称。

[in] pHashes

指向 ENCRYPTION_CERTIFICATE_HASH_LIST 结构的指针,该结构包含要从文件中删除的证书哈希列表。

返回值

如果函数成功,则返回值 ERROR_SUCCESS

如果函数失败,则返回值为系统错误代码。 有关错误代码的完整列表,请参阅 系统错误代码 或头文件 WinError.h。

注解

RemoveUsersFromEncryptedFile 函数删除指定的证书哈希(如果它们存在于指定文件中)。 如果在指定的文件中找不到任何证书哈希,则会忽略它们,并且不会返回任何错误代码。

从 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

文件加密

文件管理函数