Método I_IrmProtector.HrProtectRMS
Última modificación: miércoles, 07 de octubre de 2009
Hace referencia a: SharePoint Foundation 2010
Genera una versión administrada con derechos del archivo desprotegido especificado.
HRESULT HrProtect(
ILockBytes *pilbInput,
ILockBytes *pilbOutput,
I_ IrmPolicyInfoRMS *piid,
DWORD *pdwStatus
) PURE;
Parámetros
pilbInput
[entrada] El archivo desprotegido.
pilbOutput
[salida] La secuencia administrada con derechos que el protector de Information Rights Management (IRM) genera a partir del archivo desprotegido especificado.
piid
[entrada] Un 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_PROTECT_SUCCESS
El protector ha generado correctamente la secuencia del archivo protegido.
MSOIPI_STATUS_ALREADY_PROTECTED
El archivo ya está protegido mediante IRM.
MSOIPI_STATUS_CANT_PROTECT
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 de 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 debería devolver un valor OK positivo cuando es correcto o un valor FAIL negativo en caso contrario.
Comentarios
La Interfaz I_IrmProtector se implementa tanto mediante protectores IRM integrados como mediante protectores IRM autónomos. Para obtener más información acerca de los protectores integrados y autónomos, consulte Protectores IRM personalizados.
Para protectores IRM integrados:
Este método usa una secuencia de datos que representa un archivo desprotegido de un tipo que el protector IRM puede entender y, a continuación, genera una secuencia de datos correspondiente que representa una versión protegida de ese archivo. Esta versión protegida debe incluir la licencia de emisión del documento (IL) del archivo protegido y la EUL del servidor, así como el propio contenido del archivo cifrado.
El programador del tipo de archivos debe decidir dónde y cómo se almacenarán estos componentes dentro del archivo. No obstante, el protector IRM debe estar de acuerdo con la aplicación cliente usada para ver y editar los archivos de ese tipo.
La secuencia protegida puede incluir también un mensaje de advertencia que es compatible con versiones anteriores de los visores del cliente del tipo de archivo del protector.
Para protectores IRM autónomos:
Los protectores autónomos no necesitan implementar este método. Un protector autónomo debería devolver el resultado HRESULT E_NOTIMPL si se llama a este método.