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 ()

另请参阅

ENCRYPTION_CERTIFICATE_LIST

文件加密

文件管理函数