PermissionObject Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.Permissiontype PermissionObject = interface
interface PermissionPublic Interface PermissionObject
Implements Permission- Dérivé
- Attributs
- Implémente
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) |