I_IrmPolicyInfoRMS.HrGetSignedIL 方法
上次修改时间: 2010年4月4日
适用范围: SharePoint Foundation 2010
获取指定文档的已签名发布许可证 (IL)。
HRESULT HrGetSignedIL(
BSTR *pbstrIL
) PURE;
参数
pbstrIL
[输出] SharePoint Foundation 为文档获取的 IL。
返回值
所有 I_IrmPolicyInfoRMS 方法都返回 HRESULT 值。OK 肯定值表示该操作成功。否定的返回值表示该函数失败。
通常,如果 I_IrmPolicyInfoRMS 方法失败,则保护程序将无法从错误中恢复并且也会失败。
备注
当 SharePoint Foundation 调用集成的 IRM 保护程序来保护文档时,它首先获取该文档的许可证,然后将其存储在调用 HrProtect 方法时传递到保护程序的 I_IrmPolicyInfoRMS 对象内。HrGetSignedIL 方法为保护程序提供了一种访问文档 IL 的方法。
集成的保护程序不需要读取或理解 IL;它只需将其存储在受保护的文件内。SharePoint Foundation 已经将 Rights Management Services (RMS) 公钥应用到 IL,因此 IL 已经过签名并且可以在不修改或不加密的情况下由保护程序存储在文件中。
应该只从 I_IrmProtector.HrProtect 方法 调用此方法。
有关集成 IRM 保护程序的详细信息,请参阅自定义 IRM 保护程序。