PermissionObject - Interface
Donne accès aux objets UserPermissionObject et aux paramètres d'autorisation pouvant être appliqués à un formulaire.
Espace de noms : Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly : Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.dll)
Syntaxe
'Déclaration
<GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface PermissionObject _
Inherits Permission
'Utilisation
Dim instance As PermissionObject
[GuidAttribute("096cd6cc-0786-11d1-95fa-0080c78ee3bb")]
public interface PermissionObject : Permission
Remarques
Ce type est le wrapper d’une coclasse requise par le code managé pour l’interopérabilité COM. Utilisez ce type pour accéder aux membres de l’interface COM implémentée par cette coclasse. Pour plus d’informations sur l’interface COM et pour accéder à un lien vers les descriptions de ses membres, voirPermission.
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.
Notes
Puisque l’objet PermissionObject et ses membres ont été ajoutés au modèle objet Microsoft.Office.Interop.InfoPath.SemiTrust dans Microsoft InfoPath, 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, voir Procédure : utiliser les membres du modèle objet 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.
Notes
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
Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms