QueryUsersOnEncryptedFile 函数 (winefs.h)

检索指定文件的用户列表。

语法

DWORD QueryUsersOnEncryptedFile(
  [in]  LPCWSTR                           lpFileName,
  [out] PENCRYPTION_CERTIFICATE_HASH_LIST *pUsers
);

参数

[in] lpFileName

文件的名称。

[out] pUsers

指向接收用户列表 的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 集 在 Windows 8) 中引入的 ext-ms-win-advapi32-encryptedfile-l1-1-0 (

另请参阅

ENCRYPTION_CERTIFICATE_HASH_LIST

文件加密

文件管理函数

FreeEncryptionCertificateHashList