PermissionObject Interface

Définition

Espace de noms:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Fournit l’accès aux UserPermissionObject objets et aux paramètres d’autorisation qui peuvent être appliqués à un formulaire.

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

[System.Runtime.InteropServices.Guid("096CD6CC-0786-11D1-95FA-0080C78EE3BB")]
public interface PermissionObject : Microsoft.Office.Interop.InfoPath.Permission

type PermissionObject = interface
    interface Permission

Public Interface PermissionObject
Implements Permission

Dérivé

Microsoft.Office.Interop.InfoPath.PermissionObjectClass

Attributs

GuidAttribute

Implémente

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, y compris un lien vers les descriptions de ses membres, consultezPermission .

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 à un modèle de formulaire est retournée par la Permission propriété de la _XDocument3 classe .

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 Enabled propriété pour déterminer si un formulaire dispose d’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 propriété Enabled est définie sur la valeur true.

La DocumentAuthor propriété est définie.

La RequestPermissionURL propriété est définie.

La StoreLicenses propriété a la valeur true ou false.

La ApplyPolicy(String) méthode est appelée.

Les autorisations sur un formulaire peuvent également être activées à l’aide de la Add(String, Object, Object) méthode de l’objet Permission pour ajouter un utilisateur au formulaire.

Remarque : Les autorisations ne peuvent pas être appliquées lorsqu’un formulaire est en mode d’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 retourne toujours la valeur false et, si le code essaie de modifier ce paramètre, une exception System.Runtime.InteropServices.COMException est générée et l'erreur « La propriété/méthode n'est pas disponible en mode Aperçu » est retournée. 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.

Propriétés

Count	Obtient le nombre d’objets UserPermissionObject associés au formulaire. (Hérité de Permission)
DocumentAuthor	Obtient ou définit l'auteur du formulaire actif sous forme d'adresse électronique. (Hérité de Permission)
Enabled	Obtient ou définit l'information indiquant que les paramètres d'autorisation représentés par l'objet Permission sont activés pour le formulaire actif. (Hérité de Permission)
Item[Object]	Obtient l’objet UserPermission à l’index spécifié. (Hérité de Permission)
PermissionFromPolicy	Indique si une stratégie d'autorisation a été appliquée au formulaire actif. (Hérité de Permission)
PolicyDescription	Obtient une description de la stratégie appliquée au formulaire actif. (Hérité de Permission)
PolicyName	Obtient le nom de la stratégie appliquée au formulaire actif. (Hérité de Permission)
RequestPermissionURL	Obtient ou définit le fichier, l'URL ou l'adresse électronique que les utilisateurs doivent utiliser s'ils ont besoin d'autorisations supplémentaires sur le formulaire actif. (Hérité de Permission)
StoreLicenses	Obtient ou définit l'information indiquant que la licence permettant à l'utilisateur d'afficher le formulaire actif doit être mise en cache pour permettre son affichage en mode hors connexion lorsque l'utilisateur ne peut pas se connecter à un serveur de gestion des droits. (Hérité de Permission)

Méthodes

Add(String, Object, Object)	Crée un nouvel ensemble d'autorisations sur le formulaire actif pour l'utilisateur spécifié, comprenant les autorisations indiquées et une date d'expiration. (Hérité de Permission)
ApplyPolicy(String)	Applique une stratégie au formulaire en utilisant un fichier de modèle de stratégie. (Hérité de Permission)
GetEnumerator()	Obtient un IEnumerator pour itérer dans la collection. (Hérité de Permission)
RemoveAll()	Supprime tous les UserPermission objets associés au formulaire. (Hérité de Permission)