PermissionObject Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Proporciona acceso a los objetos y a la UserPermissionObject configuración de permisos que se pueden aplicar a un formulario.

public interface class PermissionObject : Microsoft::Office::Interop::InfoPath::SemiTrust::Permission

[System.Runtime.InteropServices.Guid("096cd6cc-0786-11d1-95fa-0080c78ee3bb")]
public interface PermissionObject : Microsoft.Office.Interop.InfoPath.SemiTrust.Permission

type PermissionObject = interface
    interface Permission

Public Interface PermissionObject
Implements Permission

Atributos

GuidAttribute

Implementaciones

Permission

Comentarios

Este tipo es un contenedor para una coclase que requiere el código administrado para la interoperabilidad con COM. Use este tipo para acceder a los miembros de la interfaz COM que implementa esta coclase. Para obtener información sobre la interfaz COM, incluido un vínculo a las descripciones de sus miembros, consultePermission .

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

La propiedad de la clase devuelvePermission una instancia de la clase Permission asociada a una plantilla de _XDocument3 formulario.

Nota: Dado que permissionObject y sus miembros se agregaron al modelo de objetos Microsoft.Office.Interop.InfoPath.SemiTrust en Microsoft InfoPath, debe convertir el objeto devuelto por la variable thisXDocument al tipo _XDocument3 para poder acceder a PermissionObject y sus miembros. Para obtener más información, vea Cómo: Usar miembros del modelo de objetos 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 Enabled propiedad 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 DocumentAuthor propiedad .

Se establece la RequestPermissionURL propiedad .

La StoreLicenses propiedad se establece en true o false.

Se llama al ApplyPolicy(String) método .

Los permisos de un formulario también se pueden habilitar mediante el Add(String, Object, Object) método del Permission objeto para agregar un usuario al formulario.

Nota: Los permisos no se pueden aplicar cuando un formulario está en 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; 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.

Propiedades

Count	Obtiene el número de UserPermissionObject objetos asociados al formulario. (Heredado de Permission)
DocumentAuthor	Obtiene o establece el autor del formulario en forma de dirección de correo electrónico. (Heredado de Permission)
Enabled	Obtiene o establece si los valores de los permisos representados por el objeto Permission están habilitados para el formulario actual. (Heredado de Permission)
Item[Object]	Obtiene el UserPermission objeto en el índice especificado. (Heredado de Permission)
PermissionFromPolicy	Obtiene si se ha aplicado una directiva de permisos al formulario actual. (Heredado de Permission)
PolicyDescription	Obtiene una descripción de la directiva que se aplicó al formulario. (Heredado de Permission)
PolicyName	Obtiene el nombre de la directiva que se aplicó al formulario. (Heredado de Permission)
RequestPermissionURL	Obtiene o establece el archivo, la dirección URL o la dirección de correo electrónico de contacto si hay usuarios que necesitan permisos adicionales en el formulario. (Heredado de Permission)
StoreLicenses	Obtiene o establece si la licencia del usuario para ver el formulario actual se debe almacenar en caché para permitir su visualización sin conexión cuando el usuario no se pueda conectar a un servidor de administración de derechos. (Heredado de Permission)

Métodos

Add(String, Object, Object)	Crea un nuevo conjunto de permisos en el formulario actual para el usuario especificado con los permisos especificados y una fecha de caducidad. (Heredado de Permission)
ApplyPolicy(String)	Aplica una directiva al formulario utilizando un archivo de plantilla de directiva. (Heredado de Permission)
GetEnumerator()	Obtiene un objeto IEnumerator para realizar una iteración en la colección. (Heredado de Permission)
RemoveAll()	Quita todos los UserPermission objetos asociados al formulario. (Heredado de Permission)