I_IrmPolicyInfoRMS.HrGetListGuid 方法
上次修改时间： 2010年4月4日
适用范围： SharePoint Foundation 2010
返回从中下载了权限管理文档的文档库的 GUID。
HRESULT HrGetListGuid(
BSTR* pbstrListGuid
) PURE;
参数
pbstrListGuid
[输出] 从中下载了受保护文档的文档库的 GUID。
返回值
所有 I_IrmPolicyInfoRMS 方法都返回 HRESULT 值。OK 肯定值表示该操作成功。否定的返回值表示该函数失败。
通常，如果 I_IrmPolicyInfoRMS 方法失败，则保护程序将无法从错误中恢复并且也会失败。
备注
当用户签入权限管理文档时，必须将该文件上载到从中下载它的同一个文档库。为此，在用户下载该文档时，SharePoint Foundation 会在文档发布许可证 (IL) 中包含文档库 GUID，集成的信息权限管理 (IRM) 保护程序然后会将该许可证存储到权限管理文档中。当用户签入该文档时，IRM 保护程序会使用 I_IrmPolicyInfoRMS.HrSetSignedIL 方法 方法提取文档 IL 并将其转发到 SharePoint Foundation。IRM 保护程序不需要了解 IL 本身。SharePoint Foundation 负责将文档 IL 中的文档库 GUID 与用户尝试将文档上载到的文档库的 GUID 进行比较。如果这两个 GUID 不匹配，SharePoint Foundation 将取消上载。
可以选择调用此方法。SharePoint Foundation 以对 IRM 保护程序透明的方式管理比较文档库 GUID 的过程。
但是，如有必要，IRM 保护程序可以使用此方法访问文档库 GUID。在受保护文件内存储 GUID 时不需要该保护程序，而且使用 SharePoint Foundation IRM 功能的标准保护程序实现不需要使用此函数。
可以在以下情况下使用此方法：IRM 保护程序创建 IL 时，或者在它必须以加密格式创建 IRM 基础结构用于取消保护的内容时。
有关集成 IRM 保护程序的详细信息，请参阅自定义 IRM 保护程序。