I_IrmProtector.HrUnprotect 方法
上次修改时间: 2009年10月7日
适用范围: SharePoint Foundation 2010
生成指定的权限管理文件的不受保护版本。
HRESULT HrUnprotect(
ILockBytes *pilbInput,
ILockBytes *pilbOutput,
I_IrmPolicyInfo *piid,
DWORD *pdwStatus
) PURE;
参数
pilbInput
[输入] 权限管理文件。
pilbOutput
[输出] 信息权限管理 (IRM) 保护程序从权限管理文件生成的不受保护流。
piid
[输入] 指向要保护文件的相关数据的链接,以及请求该链接的用户。
pdwStatus
[输入] 方法调用的状态。可能的值为:
MSOIPI_STATUS_UNKNOWN
不能确定该方法的结果。
MSOIPI_STATUS_UNPROTECT_SUCCESS
保护程序已成功生成不受保护的文件流。
MSOIPI_STATUS_ALREADY_UNPROTECTED
指定文件不受保护。
MSOIPI_STATUS_CANT_UNPROTECT
保护程序的一般故障。
MSOIPI_STATUS_NOT_MY_FILE
指定文件不是与此 IRM 保护程序关联的文件类型。
MSOIPI_STATUS_FILE_CORRUPT
指定文件已损坏。
MSOIPI_STATUS_WSS_IRM_FAILED
保护程序不能访问其权限管理平台。
MSOIPI_STATUS_BAD_INSTALL
未正确安装保护程序。
返回值
保护程序方法返回标准的 HRESULT 值。一般而言,如果成功,保护程序应返回一个肯定的 OK 值;如果失败,则返回一个否定的 FAIL 值。
备注
集成和自治 IRM 保护程序可实现 I_IrmProtector 接口。有关集成和自治保护程序的详细信息,请参阅自定义 IRM 保护程序。
对于集成 IRM 保护程序:
集成保护程序不需要实现此方法。如果调用此方法,则集成保护程序应返回 HRESULT E_NOTIMPL。
对于自治 IRM 保护程序:
SharePoint Foundation 可调用此方法以取消对此保护程序所关联文件类型的权限管理文件的保护。对于自治保护程序,必须实现 I_IrmProtector.HrProtect 方法 方法,以便它配置和执行整个权限管理过程。
通常,应实现自治保护程序的 I_IrmProtector.HrUnprotect 方法 方法,以便它完成下列任务:
使用 I_IrmPolicyInfo.HrSetListGuid 方法 方法的 piid 参数向 SharePoint Foundation 提供存储在文件的权限元数据中的文档库 GUID。SharePoint Foundation 使用此 GUID 来确保可将文件上载到当初下载该文件的文档库。
使用 pilbOutput 参数提供向 SharePoint Foundation 提供未加密版本的文件。
返回 pwdStatus 参数中的相应状态值。