Permission 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.
Verwenden Sie das Permission -Objekt zum Einschränken von Berechtigungen für das aktive Dokument und bestimmte berechtigungseinstellungen festzulegen oder zurückzugeben.
public interface class Permission : Microsoft::Office::Core::_IMsoDispObj, System::Collections::IEnumerable
[System.Runtime.InteropServices.Guid("000C0376-0000-0000-C000-000000000046")]
public interface Permission : Microsoft.Office.Core._IMsoDispObj, System.Collections.IEnumerable
[<System.Runtime.InteropServices.Guid("000C0376-0000-0000-C000-000000000046")>]
type Permission = interface
interface _IMsoDispObj
interface IEnumerable
Public Interface Permission
Implements _IMsoDispObj, IEnumerable
- Attribute
- Implementiert
Hinweise
Die Permission-Eigenschaft des Microsoft Office Word 2003 Document-Objekts , des Microsoft Office Excel 2003 Workbook-Objekts und des Microsoft Office PowerPoint 2003 Presentation-Objekts gibt ein Permission-Objekt zurück.
Verwenden Sie die Enabled -Eigenschaft, um zu bestimmen, ob Berechtigungen für das aktive Dokument eingeschränkt sind. Verwenden Sie die Count -Eigenschaft, um die Anzahl der Benutzer mit Berechtigungen zurückzugeben, und die RemoveAll() -Methode, um alle vorhandenen Berechtigungen zurückzusetzen.
Die DocumentAuthorEigenschaften , EnableTrustedBrowser, RequestPermissionURLund StoreLicenses stellen zusätzliche Informationen zu Berechtigungseinstellungen bereit.
Das Permission-Objekt ermöglicht den Zugriff auf eine Auflistung von UserPermission -Objekten. Verwenden Sie das UserPermission-Objekt, um bestimmte Gruppen von Rechten einzelnen Benutzern zuzuordnen. Während einige Berechtigungen, die über die Benutzeroberfläche erteilt werden (z. B. msoPermissionPrint), für alle Benutzer gelten, können Sie das UserPermission-Objekt verwenden, um Berechtigungen individuell pro Benutzer und mit individuellem Ablaufdatum zuzuweisen.
Microsoft Office Information Rights Management unterstützt die Verwendung von administrativen Berechtigungsrichtlinien, die Benutzer und Gruppen sowie deren Dokumentberechtigungen auflisten. Verwenden Sie die ApplyPolicy(String) -Methode, um eine Berechtigungsrichtlinie und die PermissionFromPolicyEigenschaften , PolicyNameund PolicyDescription anzuwenden, um Richtlinieninformationen zurückzugeben.
Das Permission-Objektmodell ist verfügbar, unabhängig davon, ob Berechtigungen für das aktive Dokument eingeschränkt sind. Die Permission-Eigenschaft der Objekte Document, Workbook und Presentation gibt nicht Nothing zurück, wenn das aktive Dokument nicht über eingeschränkte Berechtigungen verfügt. Verwenden Sie die Enabled -Eigenschaft, um zu bestimmen, ob ein Dokument über eingeschränkte Berechtigungen verfügt.
Verwendung des Permission -Objekts löst einen Fehler aus, wenn der Windows-Rechteverwaltungsclient nicht installiert ist.
Eigenschaften
Application |
Gibt ein Application-Objekt zurück, das die Containeranwendung für das -Objekt darstellt. |
Count |
Gibt einen Integer-Wert zurück, der die Anzahl der Elemente in der angegebenen Auflistung angibt. |
Creator |
Gibt eine 32-Bit-Ganzzahl, die die Anwendung angibt, in der das angegebene Objekt erstellt wurde. |
DocumentAuthor |
Gibt den Namen des Autors des aktiven Dokuments in E-Mail-Form zurück oder legt den Namen fest. |
Enabled |
Gibt einen booleschen Wert zurück, der angibt, ob Berechtigungen für das aktive Dokument aktiviert sind, oder legt diesen wert fest. |
EnableTrustedBrowser |
Gibt die Option zurück, die es einem Benutzer ermöglicht, ein Dokument mit eingeschränkten Berechtigungen in einem Webbrowser anzuzeigen, wenn die entsprechende Clientanwendung nicht installiert ist, oder legt diese Option fest. |
Item[Object] |
Gibt ein UserPermission -Objekt zurück, das ein Element der Permission Auflistung ist. |
Parent |
Gibt das Parent-Objekt für das angegebene Objekt zurück. |
PermissionFromPolicy |
Gibt einen booleschen Wert zurück, der angibt, ob eine Berechtigungsrichtlinie auf das aktive Dokument angewendet wurde. |
PolicyDescription |
Gibt die Beschreibung der Berechtigungsrichtlinie zurück, die auf das aktive Dokument angewendet wird. |
PolicyName |
Gibt den Namen der Berechtigungsrichtlinie zurück, die auf das aktive Dokument angewendet wird. |
RequestPermissionURL |
Gibt die zu besuchende Datei- oder Website-URL oder die E-Mail-Adresse für Benutzer zurück, die zusätzliche Berechtigungen für das aktive Dokument benötigen, oder legt diese fest. |
StoreLicenses |
Gibt einen booleschen Wert zurück, der angibt, ob die Lizenz des Benutzers zum Anzeigen des aktiven Dokuments zwischengespeichert werden soll, um die Offlineanzeige zu ermöglichen, wenn der Benutzer keine Verbindung mit einem Rights Management-Server herstellen kann. |
Methoden
Add(String, Object, Object) |
Erstellt einen neuen Berechtigungssatz für das aktive Dokument für den angegebenen Benutzer. |
ApplyPolicy(String) |
Wendet die angegebene Berechtigungsrichtlinie für das aktive Dokument an. |
GetEnumerator() |
Verwenden Sie das Permission -Objekt zum Einschränken von Berechtigungen für das aktive Dokument und bestimmte berechtigungseinstellungen festzulegen oder zurückzugeben. |
RemoveAll() |
Entfernt alle UserPermission Objekte aus der Permission Auflistung des aktiven Dokuments und deaktiviert Einschränkungen für das aktive Dokument. |