I_IrmPolicyInfo.HrSetListGuid 方法

上次修改时间: 2009年10月7日

适用范围: SharePoint Foundation 2010

设置从其中下载文档的文档库的 GUID。

HRESULT HrSetListGuid(
    BSTR  bstrListGuid
    );

参数

bstrListGuid

[输入] 设置从其中下载文档的文档库的 GUID。

返回值

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

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

备注

自治保护程序的 I_IrmProtector.HrUnprotect 方法 方法必须从权限管理文档中提取文档库 GUID,并将该值传递给 I_IrmPolicyInfo.HrSetListGuid 方法 方法。

然后,SharePoint Foundation 会将此 GUID 与用户尝试将权限管理文档上载到的文档库的 GUID 进行比较。如果两个 GUID 不匹配,SharePoint Foundation 将取消文档上载。由于权限设置为文档库级别,因此这将有助于确保用户保留该文件的适当权限。

自治保护程序的 I_IrmProtector.HrProtect 方法 方法应已将文档库 GUID 存储在权限管理的文件中。

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

请参阅

引用

I_IrmProtector 接口

I_IrmPolicyInfo 类

概念

SharePoint Foundation 中的信息权限管理

自定义 IRM 保护程序