PermissionObject Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bietet Zugriff auf UserPermissionObject Objekte und Berechtigungseinstellungen, die auf ein Formular angewendet werden können.
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- Abgeleitet
- Attribute
- Implementiert
Hinweise
Dieser Typ ist ein Wrapper für eine CoClass, die von verwaltetem Code für COM-Interoperabilität benötigt wird. Verwenden Sie diesen Typ, um auf die Mitglieder der COM-Schnittstelle zuzugreifen, die von dieser CoClass implementiert wird. Informationen zur COM-Schnittstelle, einschließlich eines Links zu Beschreibungen ihrer Member, finden Sie unterPermission .
Verwenden Sie die PermissionObject-Klasse und deren Member, um die Berechtigungen auf das aktive Formular einzuschränken und bestimmte Berechtigungseinstellungen abzurufen oder festzulegen.
Eine Instanz der Permission-Klasse , die einer Formularvorlage zugeordnet ist, wird von der Permission -Eigenschaft der _XDocument3 -Klasse zurückgegeben.
Das zurückgegebene PermissionObject-Objekt ermöglicht den Zugriff auf die der Formularvorlage zugeordneten UserPermissionObject-Objekte und auf jede mit dieser Vorlage erstellte Formularinstanz. Jedes UserPermissionObject-Objekt dient zum Definieren einer bestimmten Regelgruppe für einen einzelnen Benutzer. Während einige Berechtigungen, die über die Benutzeroberfläche erteilt werden, auf alle Benutzer angewendet werden, können Sie das UserPermissionObject-Objekt verwenden, um die Berechtigung auf einer benutzerbezogenen Basis mit benutzerbezogenem Ablaufdatum zuzuweisen.
Das PermissionObject-Objekt und seine Eigenschaften und Methoden sind unabhängig davon verfügbar, ob die Berechtigungen für die aktive Formularvorlage eingeschränkt sind oder nicht. Verwenden Sie die Enabled -Eigenschaft, um zu bestimmen, ob ein Formular über eingeschränkte Berechtigungen verfügt.
Wenn der Windows-Rechteverwaltungsclient nicht auf einem Benutzercomputer installiert ist, löst die Verwendung des PermissionObject-Objekts eine Ausnahme aus.
Berechtigungen für ein Formular werden auf eine der folgenden Arten mithilfe von Eigenschaften und Methoden des PermissionObject-Objekts aktiviert:
Die Enabled-Eigenschaft ist auf true festgelegt.
Die DocumentAuthor -Eigenschaft ist festgelegt.
Die RequestPermissionURL -Eigenschaft ist festgelegt.
Die StoreLicenses -Eigenschaft ist auf TRUE oder FALSE festgelegt.
Die ApplyPolicy(String) -Methode wird aufgerufen.
Berechtigungen für ein Formular können auch mithilfe der Add(String, Object, Object) -Methode des Permission -Objekts aktiviert werden, um dem Formular einen Benutzer hinzuzufügen.
Hinweis: Berechtigungen können nicht angewendet werden, wenn sich ein Formular im Vorschaumodus befindet. Aus diesem Grund sind alle Eigenschaften des PermissionObject-Objekts schreibgeschützt, wenn die Vorschau für ein Formular angezeigt wird. Im Vorschaumodus gibt die Enabled-Eigenschaft immer false zurück, und wenn der Code versucht, diese Einstellung zu ändern, wird System.Runtime.InteropServices.COMException ausgelöst und der Fehler "Die Eigenschaft/Methode ist im Vorschaumodus nicht verfügbar" zurückgegeben. Auf ähnliche Weise geben die Methoden, die den Objekten PermissionObject und UserPermissionObject zugeordnet sind, diese Fehlermeldung zurück, wenn sie im Vorschaumodus verwendet werden.
Eigenschaften
| Count |
Ruft die Anzahl der UserPermissionObject -Objekte ab, die dem Formular zugeordnet sind. (Geerbt von Permission) |
| DocumentAuthor |
Ruft den Autor des aktuellen Formulars als E-Mail-Adresse ab, oder legt ihn fest. (Geerbt von Permission) |
| Enabled |
Ruft ab, ob die durch das Permission-Objekt dargestellten Berechtigungseinstellungen für das aktuelle Formular aktiviert sind, oder legt diese Einstellung fest. (Geerbt von Permission) |
| Item[Object] |
Ruft das UserPermission -Objekt am angegebenen Index ab. (Geerbt von Permission) |
| PermissionFromPolicy |
Ruft ab, ob eine Berechtigungsrichtlinie auf das aktuelle Formular angewendet wurde. (Geerbt von Permission) |
| PolicyDescription |
Ruft eine Beschreibung der Richtlinie ab, die auf dem aktuellen Formular angewendet wurde. (Geerbt von Permission) |
| PolicyName |
Ruft den Namen der Richtlinie ab, die auf dem aktuellen Formular angewendet wurde. (Geerbt von Permission) |
| RequestPermissionURL |
Ruft die Datei, den URL oder die E-Mail-Adresse ab, an die sich Benutzer wenden müssen, die zusätzliche Berechtigungen für das aktuelle Formular benötigen, oder legt sie fest. (Geerbt von Permission) |
| StoreLicenses |
Ruft ab, ob die Benutzerlizenz zum Anzeigen des aktuellen Formulars zwischengespeichert werden soll, um die Offlineanzeige zuzulassen, wenn der Benutzer keine Verbindung zu einem Rechteverwaltungsserver herstellen kann, oder legt diese Einstellung fest. (Geerbt von Permission) |
Methoden
| Add(String, Object, Object) |
Erstellt eine neue Berechtigungsgruppe für das aktuelle Formular für den angegebenen Benutzer mit den angegebenen Berechtigungen und einem Ablaufdatum. (Geerbt von Permission) |
| ApplyPolicy(String) |
Wendet eine Richtlinie auf das Formular mithilfe einer Richtlinienvorlagendatei an. (Geerbt von Permission) |
| GetEnumerator() |
Ruft IEnumerator zum Durchlaufen der Auflistung ab. (Geerbt von Permission) |
| RemoveAll() |
Entfernt alle UserPermission dem Formular zugeordneten Objekte. (Geerbt von Permission) |