IUrlAccessor3::GetImpersonationSidBlobs 方法 (searchapi.h)
检索指定 URL 的 SID) (用户安全标识符数组。 此方法使协议处理程序可以指定哪些用户可以访问文件,以及搜索协议主机来模拟用户以便为文件编制索引。
语法
HRESULT GetImpersonationSidBlobs(
[in] LPCWSTR pcwszURL,
[out] DWORD *pcSidCount,
[out] BLOB **ppSidBlobs
);
parameters
[in] pcwszURL
类型: LPCWSTR
要代表模拟用户访问的 URL。
[out] pcSidCount
类型: DWORD*
接收指向 ppSidBlobs 中返回的用户 SID 数量的指针。
[out] ppSidBlobs
类型: BLOB**
接收指向候选模拟用户 SID 数组的指针的地址。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
如果文件已加密,此方法将标识谁可以解密和访问它。 如果 方法无法识别此信息,则失败并E_ACCESSDENIED错误代码。
此方法假定 IUrlAccessor2 对象初始化失败,并 返回代码PRTH_S_TRY_IMPERSONATING。 然后,搜索协议主机调用此方法来检索要用于模拟的 SID 列表,并还原为使用 IUrlAccessor2,在打开项目时模拟允许的用户之一。
模拟用户不会提升调用方的权限。 如果调用方无法直接检索有权访问资源的用户列表,则调用方也无法使用此方法执行此操作。 只有搜索协议主机和索引器具有足够的权限来模拟当前登录的用户。
要求
最低受支持的客户端 | 带 SP2 的 Windows XP、带 SP2 的 Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
目标平台 | Windows |
标头 | searchapi.h |
可再发行组件 | Windows 搜索 (WS) 4.0 |