IUrlAccessor::GetSecurityDescriptor 方法 (searchapi.h)
获取 URL 项的安全描述符。 安全性在查询时应用,因此此描述符标识读取访问的安全性。
语法
HRESULT GetSecurityDescriptor(
[out] BYTE *pSD,
[in] DWORD dwSize,
[out] DWORD *pdwLength
);
参数
[out] pSD
类型: BYTE*
接收指向安全描述符的指针。
[in] dwSize
类型:DWORD
pSD 数组的大小(以 TCHAR为单位)。
[out] pdwLength
类型: DWORD*
接收指向写入 pSD 的 TCHAR 数的指针,不包括终止 NULL。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
此方法允许在注册到内容源的用户与在域上注册的用户之间进行自定义映射(如果它们不同)。 在此方法中创建的安全描述符必须是自相对的。
如果 URL 包含用户安全标识符 (SID) ,则会在该用户的安全上下文中调用协议处理程序,此方法必须返回E_NOTIMPL。
如果 URL 不包含用户 SID,则会在系统服务的安全上下文中调用协议处理程序。 在这种情况下,此方法可以返回访问控制列表 (ACL) 来限制读取访问,或 PRTH_S_ACL_IS_READ_EVERYONE 允许任何人在查询期间进行读取访问。
注意 如果此方法返回E_NOTIMPL并且 URL 不包含用户 SID,则所有用户查询都可以检索该项。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP SP2、Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
目标平台 | Windows |
标头 | searchapi.h |
可再发行组件 | Windows 桌面搜索 (WDS) 3.0 |