Método I_IrmProtector.HrUnprotectRMS
Última modificación: miércoles, 07 de octubre de 2009
Hace referencia a: SharePoint Foundation 2010
Genera una versión no protegida del archivo administrado mediante derechos que se ha especificado.
HRESULT HrUnprotect(
ILockBytes *pilbInput,
ILockBytes *pilbOutput,
I_IrmPolicyInfoRMS *piid,
DWORD *pdwStatus
) PURE;
Parámetros
pilbInput
[entrada] Archivo administrado con derechos.
pilbOutput
[salida] Secuencia no protegida que el protector de Information Rights Management (IRM) genera a partir del archivo administrado con derechos.
piid
[entrada] Vínculo a funciones y datos útiles para el proceso de cifrado y descifrado.
pdwStatus
[entrada] El estado de la llamada al método. Los valores posibles son:
MSOIPI_STATUS_UNKNOWN
El resultado del método no se puede determinar.
MSOIPI_STATUS_UNPROTECT_SUCCESS
El protector ha generado correctamente la secuencia de archivos no protegidos.
MSOIPI_STATUS_ALREADY_UNPROTECTED
El archivo especificado no está protegido.
MSOIPI_STATUS_CANT_UNPROTECT
Error general del protector.
MSOIPI_STATUS_NOT_MY_FILE
El archivo especificado no es un tipo de archivo asociado con este protector IRM.
MSOIPI_STATUS_FILE_CORRUPT
El archivo especificado está dañado.
MSOIPI_STATUS_WSS_IRM_FAILED
El protector no puede tener acceso a funciones SharePoint Foundation o bien hay errores en dichas funciones de cifrado.
MSOIPI_STATUS_BAD_INSTALL
El protector no está instalado correctamente.
Valor devuelto
Los métodos del protector devuelven valores HRESULT típicos. En general, el protector debe devolver un valor OK positivo si es correcto o un valor FAIL negativo si es incorrecto.
Comentarios
La Interfaz I_IrmProtector se implementa mediante protectores IRM tanto autónomos como integrados. Para obtener más información, consulte Protectores IRM personalizados.
Para protectores IRM integrados:
SharePoint Foundation llama a este método para desproteger archivos administrados con derechos de los tipos de archivo asociados a este protector.
Este método debe extraer la licencia de emisión (IL) de documento y la licencia de usuario final (EUL) del servidor del archivo protegido. (Estos certificados se incluyeron en el archivo protegido cuando se generó el método Método I_Irm.HrProtect del protector). A continuación, el protector puede usar estos certificados para obtener acceso a métodos Clase I_IrmPolicyInfo para desproteger y descifrar el archivo.
Para los protectores IRM autónomos:
Los protectores autónomos no necesitan implementar este método. Un protector autónomo debe devolver el resultado HRESULT E_NOTIMPL si se llama a este método.