I_IrmPolicyInfoRMS.HrSetServerEUL 方法

上次修改时间: 2010年9月28日

适用范围: SharePoint Foundation 2010

设置服务器的最终用户许可证 (EUL)。

HRESULT HrSetServerEUL(
    BSTR bstrEUL
) PURE;

参数

bstrEUL

[输入] 服务器 EUL。

返回值

所有 I_IrmPolicyInfoRMS 方法都返回 HRESULT 值。OK 肯定值表示该操作成功。否定的返回值表示该函数失败。

通常,如果 I_IrmPolicyInfoRMS 方法失败,则保护程序将无法从错误中恢复并且也会失败。

备注

若要对权限管理文件中的数据进行解密,则 SharePoint Foundation 需要文档发放许可证 (IL) 和服务器 EUL。集成的信息权限管理 (IRM) 保护程序可使用此方法来设置服务器 EUL。SharePoint Foundation 使用该 EUL 来设置解密过程。

文档 IL 和服务器 EUL 均存储在权限管理文件中。已调用的 IRM 保护程序的 HrUnprotect 方法必须能够从受保护的文档中提取这两个证书。然后,HrUnprotect 方法可以调用 HrSetSignedIL 来设置 SharePoint Foundation 的 IL,并调用 HrSetServerEUL 来设置服务器 EUL。

HrUnprotect 方法不负责以任何方式修改 EUL。SharePoint Foundation 可以使用服务器私钥直接对服务器 EUL 进行解密。

在调用 HrSetServerEUL 时,如果保护程序传递 bstrEUL 的 NULL 值,则 SharePoint Foundation 必须与权限管理服务 (RMS) 服务器联系并获取新的 EUL。应仅在保护程序不包含存储 EUL 并且保护程序已调用 HrSetSignedIL 时执行此操作。

有关集成的 IRM 保护程序的详细信息,请参阅自定义 IRM 保护程序

请参阅

引用

I_IrmProtector 接口

I_IrmPolicyInfoRMS 类

I_IrmPolicyInfo 类

概念

SharePoint Foundation 中的信息权限管理

自定义 IRM 保护程序