AddUsersToEncryptedFile 函数 (winefs.h)
将用户密钥添加到指定的已加密文件。
语法
DWORD AddUsersToEncryptedFile(
[in] LPCWSTR lpFileName,
[in] PENCRYPTION_CERTIFICATE_LIST pEncryptionCertificates
);
参数
[in] lpFileName
加密文件的名称。
[in] pEncryptionCertificates
指向 ENCRYPTION_CERTIFICATE_LIST 结构的指针，该结构包含要添加到文件的新用户密钥的列表。
返回值
如果函数成功，则返回值 ERROR_SUCCESS。
如果函数失败，则返回值为系统错误代码。 有关错误代码的完整列表，请参阅 系统错误代码 或头文件 WinError.h。
注解
从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 集 | Windows 10版本 10.0.14393 中引入的 ext-ms-win-advapi32-encryptedfile-l1-1-1 () |