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

请参阅

IUrlAccessor3

IUrlAccessor4

搜索协议处理程序错误消息