上次修改时间： 2009年10月7日
适用范围： SharePoint Foundation 2010
生成指定的权限管理文件的未受保护版本。
HRESULT HrUnprotect(
ILockBytes *pilbInput,
ILockBytes *pilbOutput,
I_IrmPolicyInfoRMS *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
保护程序无法访问 SharePoint Foundation 函数，或这些加密函数已失败。
MSOIPI_STATUS_BAD_INSTALL
保护程序安装不正确。
返回值
保护程序方法返回典型的 HRESULT 值。一般而言，保护程序应返回正 OK 值表示成功，返回负 FAIL 值表示失败。
备注
I_IrmProtector 接口 由集成和自治 IRM 保护程序实现。有关集成和自治保护程序的详细信息，请参阅自定义 IRM 保护程序。
对于集成 IRM 保护程序：
SharePoint Foundation 会调用此方法来取消对与此保护程序相关联的文件类型的权限管理文件的保护。
此方法必须从受保护的文件中提取文档发布许可证 (IL) 和服务器 EUL。（当受保护的文件由保护程序的 I_IrmProtector.HrProtect 方法 方法生成时，这些证书包含在受保护的文件中。）然后，保护程序可以使用这些证书来访问 I_IrmPolicyInfo 类 方法，以取消对文件的保护并解密该文件。
对于自治 IRM 保护程序：
自治保护程序不需要实现此方法。如果此方法被调用，则自治保护程序应返回 HRESULT E_NOTIMPL。