I_IrmPolicyInfoRMS.HrGetEULs 方法
上次修改时间： 2010年4月4日
适用范围： SharePoint Foundation 2010
获取信息权限管理 (IRM) 保护程序应包含在受保护文档中的最终用户许可证 (EUL)。
HRESULT HrGetEULs(
BSTR *rgbstrEUL,
BSTR *rgbstrId,
UINT *pcbEULs
) PURE;
参数
rgbstrEUL
[输出] IRM 保护程序应将其添加到文档的 EUL。
rgbstrId
[输出] 要包含在文档中的 EUL 的所有者的 ID。
此参数和 rgbstrEUL 使用相同的索引。例如，rgbstrEUL[2] 处的 EUL 的所有者包含在 rgbstrId[2]. 处。
pcEUL
[输出] rgbstrEUL 和 rgbstrId 中元素的数目。
返回值
所有 I_IrmPolicyInfoRMS 方法都返回 HRESULT 值。OK 肯定值表示该操作成功。否定的返回值表示该函数失败。
通常，如果 I_IrmPolicyInfoRMS 方法失败，则保护程序将无法从错误中恢复并且也会失败。
备注
当前，此方法只传递服务器 EUL。
若要正确使用此方法，集成 IRM 保护程序必须调用此方法两次。第一次，保护程序应将 NULL 作为 rgbstrEUL 和 rgbstrId 形参的实参进行传递；然后，此方法返回表示 EUL 的数目的 pcEUL 中的一个值。然后，保护程序可分配适当的内存并再次调用此方法。保护程序负责释放此过程中使用的任何内存。
集成保护程序不需要读取或了解 EUL；它只需要将数据存储在受保护的文件内。SharePoint Foundation 已经将 Rights Management Services (RMS) 公钥应用到 EUL，所以 EUL 已经过签名并可以通过保护程序（无需修改或加密）存储在文件中。
将 EUL 存储在文档本身中后，当尝试解密文档时，服务器不必与 RMS 服务器重新连接。
有关集成 IRM 保护程序的详细信息，请参阅自定义 IRM 保护程序。