PermissionObject, interface

Donne accès aux objets UserPermissionObject et aux paramètres d'autorisation pouvant être appliqués à un formulaire.

  Alternative conforme à la spécification CLS :

Espace de noms : Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly : Microsoft.Office.Interop.InfoPath.SemiTrust (dans microsoft.office.interop.infopath.semitrust.dll)

Syntaxe

<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

Remarques

Ce type est le wrapper d'une classe de composants (coclass) requise par le code managé pour l'interopérabilité COM. Ce type permet d'accéder aux membres de l'interface COM implémentés par cette classe de composants. Pour plus d'informations sur l'interface COM, et pour accéder aux descriptions de ses membres, voir Permission.

Utilisez la classe PermissionObject et ses membres pour restreindre les autorisations sur le formulaire actif et pour obtenir ou définir des paramètres d'autorisation spécifiques.

Une instance de la classe Permission associée au modèle de formulaire est renvoyée par la propriété Permission de la classe _XDocument3.

Remarque

Puisque l'objet PermissionObject et ses membres ont été ajoutés au modèle objet Microsoft.Office.Interop.InfoPath.SemiTrust dans Microsoft Office InfoPath 2007, vous devez envoyer l'objet renvoyé par la variable thisXDocument au type _XDocument3 pour pouvoir accéder à l'objet PermissionObject et à ses membres. Pour plus d'informations, consultez Utilisation des membres Microsoft.Office.Interop.InfoPath.SemiTrust qui ne sont pas compatibles avec InfoPath 2003.

L'objet PermissionObject renvoyé permet d'accéder aux objets UserPermissionObject avec le modèle de formulaire et à chaque instance de formulaire créée avec ce modèle. Chaque objet UserPermissionObject est utilisé pour définir un ensemble spécifique de droits pour un utilisateur donné. Alors que certaines autorisations accordées au travers de l'interface utilisateur s'appliquent à tous les utilisateurs, vous pouvez utiliser l'objet UserPermissionObject pour attribuer des autorisations utilisateur par utilisateur, ainsi que des dates d'expiration correspondantes.

L'objet PermissionObject et ses propriétés et méthodes sont disponibles, que les autorisations sur le modèle de formulaire actif soient restreintes ou non. Utilisez la propriété Enabled pour savoir si un formulaire est associé à des autorisations restreintes.

Si le client Windows Rights Management n'est pas installé sur l'ordinateur de l'utilisateur, l'utilisation de l'objet PermissionObject génère une exception.

Les autorisations sur un formulaire sont activées de l'une des façons suivantes en utilisant les propriétés et les méthodes de l'objet PermissionObject :

La valeur de la propriété Enabled est définie comme true.

La propriété DocumentAuthor est définie.

La propriété RequestPermissionURL est définie.

La valeur de la propriété StoreLicenses est définie sur true ou sur false.

La méthode ApplyPolicy est appelée.

Il est aussi possible d'activer les autorisations sur un formulaire en utilisant la méthode Add de l'objet Permission pour ajouter un utilisateur au formulaire.

Remarque

Aucune autorisation ne peut être appliquée lorsqu'un formulaire est en mode Aperçu. Par conséquent, lorsque le formulaire est en mode Aperçu, toutes les propriétés de l'objet PermissionObject sont en lecture seule. En mode Aperçu, la propriété Enabled renvoie toujours false et si le code tente de modifier ce paramètre, une System.Runtime.InteropServices.COMException est générée et l'erreur « La méthode/propriété n'est pas disponible en mode aperçu » est renvoyé. De même, les méthodes associées aux objets PermissionObject et UserPermissionObject renvoient aussi ce message d'erreur lorsqu'elles sont utilisées en mode Aperçu.

Voir aussi

Référence

Membres PermissionObject
Microsoft.Office.Interop.InfoPath.SemiTrust, espace de noms