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 中引入) |