PermissionObject (Interfaz)

Proporciona acceso a los objetos UserPermissionObject y a los valores de los permisos que se aplican a un formulario.

  La alternativa compatible con CLS es

Espacio de nombres: Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado: Microsoft.Office.Interop.InfoPath.SemiTrust (en microsoft.office.interop.infopath.semitrust.dll)

Sintaxis

<CLSCompliantAttribute(False)> _
<GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")> _
<CoClassAttribute(GetType(PermissionObjectWrapper))> _
Public Interface PermissionObject
    Inherits Permission

Dim instance As PermissionObject

[CLSCompliantAttribute(false)] 
[GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")] 
[CoClassAttribute(typeof(PermissionObjectWrapper))] 
public interface PermissionObject : Permission

Comentarios

Este tipo es un contenedor para una coclase que necesita el código administrado para su interoperabilidad COM. Use este tipo para obtener acceso a los miembros de la interfaz COM implementada por esta coclase. Para obtener información sobre la interfaz COM, así como un vínculo a descripciones de sus miembros, vea Permission.

Use la clase PermissionObject y sus miembros para restringir los permisos al formulario activo y obtener o establecer valores de permisos específicos.

Se devuelve una instancia de la clase Permission asociada a una plantilla de formulario por la propiedad _XDocument3 de la clase Permission.

Nota:

Dado que PermissionObject y sus miembros se agregaron al modelo de objetos de Microsoft.Office.Interop.InfoPath.SemiTrust en Microsoft Office InfoPath 2007, debe convertir el objeto devuelto por la variable thisXDocument en el tipo _XDocument3 para poder tener acceso a PermissionObject y todos sus miembros. Para obtener más información, vea Cómo: Usar los miembros de Microsoft.Office.Interop.InfoPath.SemiTrust que no son compatibles con InfoPath 2003.

El objeto devuelto PermissionObject proporciona acceso a los objetos UserPermissionObject asociados a la plantilla de formulario y a todas las instancias de formulario creadas con la plantilla. Cada objeto UserPermissionObject se usa para definir un conjunto específico de derechos para un usuario individual. Si bien algunos permisos concedidos mediante la interfaz de usuario se aplican a todos los usuarios, puede usar el objeto UserPermissionObject para asignar permisos usuario por usuario, con fechas de caducidad para cada usuario.

El objeto PermissionObject y sus propiedades y métodos están disponibles tanto si los permisos están restringidos en la plantilla del formulario activo como si no lo están. Use la propiedad Enabled para determinar si un formulario tiene permisos restringidos.

Si el cliente de Windows Rights Management no está instalado en el equipo de un usuario, al usar el objeto PermissionObject se produce una excepción.

Los permisos de un formulario se pueden activar de una de las formas siguientes utilizando los métodos y las propiedades del objeto PermissionObject:

La propiedad Enabled se establece en true.

Se establece la propiedad DocumentAuthor.

Se establece la propiedad RequestPermissionURL.

Se establece la propiedad StoreLicenses comotrue o false.

Se llama al método ApplyPolicy.

Los permisos de un formulario también se pueden habilitar por medio del método Add del objeto Permission para agregar un usuario al formulario.

Nota:

Los permisos no se pueden aplicar cuando un formulario está en el modo de vista previa. Por ello, todas las propiedades del objeto PermissionObject son de sólo lectura cuando se está en la vista previa de un formulario. En el modo de vista previa, la propiedad Enabled devolverá siempre false y si el código trata de cambiar este valor, se produce una excepción System.Runtime.InteropServices.COMException y se devuelve un mensaje de error que dice "La propiedad o el método no está disponible en el modo de vista previa". De la misma manera, los métodos asociados a los objetos PermissionObject y UserPermissionObject devolverán este mensaje de error si se usan en el modo de vista previa.

Vea también

Referencia

PermissionObject (Miembros)
Microsoft.Office.Interop.InfoPath.SemiTrust (Espacio de nombres)