Método I_Irm.HrProtect
Última modificación: miércoles, 07 de octubre de 2009
Hace referencia a: SharePoint Foundation 2010
Genera una versión con derechos administrados del archivo desprotegido especificado.
HRESULT HrProtect(
ILockBytes *pilbInput,
ILockBytes *pilbOutput,
I_IrmPolicyInfo *piid,
DWORD *pdwStatus
) PURE;
Parámetros
pilbInput
[entrada] El archivo desprotegido.
pilbOutput
[salida] La secuencia con derechos administrados que el protector de Information Rights Management (IRM) genera a partir del archivo desprotegido especificado.
piid
[entrada] Un vínculo a datos sobre el archivo que debe protegerse y el usuario que lo solicita.
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 obtener acceso a la plataforma de administración de derechos.
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 mediante protectores IRM tanto autónomos como integrados. Para obtener más información sobre protectores autónomos e integrados, consulte Protectores IRM personalizados.
Para protectores IRM integrados:
Los protectores integrados no necesitan implementar este método. Si se llama a este método, un protector integrado debe devolver el valor HRESULT E_NOTIMPL.
Para protectores IRM autónomos:
Este método toma una secuencia de datos que representa un archivo desprotegido de un tipo que el protector IRM puede comprender y, a continuación, genera una secuencia de datos correspondiente que representa una versión protegida de ese archivo. Para protectores autónomos, debe implementar el método Método I_Irm.HrProtect de modo que configure y ejecute todo el proceso de administración de derechos.
Si se usa el objeto Clase I_IrmPolicyInfo que pasa SharePoint Foundation como argumento de piid, se puede obtener acceso a la siguiente información:
El GUID y la dirección URL de la biblioteca de documentos en la que se encuentra el archivo solicitado.
La dirección de correo electrónico del usuario que solicita el archivo y una máscara de derechos que especifica los derechos que ese usuario tiene sobre el archivo.
El título y la descripción de la directiva IRM de la biblioteca de documentos.
El número de días que el usuario debe tener acceso al archivo.
Es responsabilidad del protector autónomo traducir estos datos en algo que pueda comprender una aplicación cliente compatible con IRM.
En general, el método Método I_Irm.HrProtect de un protector autónomo debe implementarse de manera que realice las siguientes tareas:
Cifrar las partes confidenciales del archivo solicitado.
Conceder al usuario que solicita el archivo permisos correctos sobre el archivo con derechos administrados.
Conceder control total sobre el archivo con derechos administrados al servidor de SharePoint Foundation, o a otro usuario al que el método Método I_IrmProtector.HrUnprotect de este protector autónomo tenga acceso.
Agregar el GUID de la biblioteca de documentos a los metadatos de derechos del archivo.
Agregar los otros metadatos de derechos, como el título y la descripción de la directiva, al archivo según corresponda.
Devolver el valor de estado apropiado en el argumento pwdStatus.
El programador del tipo de archivos debe decidir el lugar y la forma en que estos componentes se guardan 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 de cliente del tipo de archivo del protector.