User2.IsUserMemberOf-Methode

Článek
04/27/2010

Gibt einen Wert zurück, der angibt, ob der aktuelle Benutzer Mitglied der angegebenen Gruppe ist.

Namespace: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Syntax

'Declaration
<DispIdAttribute(2)> _
Function IsUserMemberOf ( _
    <InAttribute> bstrGroupname As String _
) As Boolean
'Usage
Dim instance As User2
Dim bstrGroupname As String
Dim returnValue As Boolean

returnValue = instance.IsUserMemberOf(bstrGroupname)

[DispIdAttribute(2)] 
bool IsUserMemberOf (
    [InAttribute] string bstrGroupname
)

Parameter

bstrGroupname
Der Gruppenname entspricht dem Format "Domäne\Gruppenname".

Rückgabewert

true, wenn der aktuelle Benutzer Mitglied der angegebenen Gruppe ist; andernfalls false.

Hinweise

Obwohl die IsUserMemberOf-Methode die Sicherheitsebene 0 aufweist, kann nicht immer darauf zugegriffen werden. Wenn die IsUserMemberOf-Methode aufgerufen wird, wird von InfoPath zuerst eine Sicherheitsprüfung durchgeführt, um zu bestimmen, ob der Zugriff auf diese Methode zulässig ist. Die Sicherheitsprüfung bestätigt, ob der aufrufende Code vertrauenswürdig ist oder nicht, und bestimmt die Position dieses Codes.

Wenn der aufrufende Code vertrauenswürdig ist (dies trifft z. B. zu, wenn die IsUserMemberOf-Methode von einer installierten oder signierten InfoPath-Formularvorlage aus oder von vertrauenswürdigem externem Code, wie etwa einer ausführbaren Datei auf dem lokalen Computer, aufgerufen wird), ermöglicht InfoPath den Vollzugriff auf die IsUserMemberOf-Methode.

Wenn der aufrufende Code nicht vertrauenswürdig ist (dies trifft z. B. bei einem Aufruf von einer domänenbasierten InfoPath-Formularvorlage oder von einem Skript zu, das in Microsoft Internet Explorer ausgeführt wird), wird von InfoPath zuerst überprüft, woher der Aufruf stammt. Wenn der Aufruf von nicht vertrauenswürdigem Code in einer InfoPath-Formularvorlage unter einem URL wie "https://www.contoso.com/Beispiel.xsn" stammt, kommt er aus dem Internet. InfoPath verweigert allen nicht vertrauenswürdigen Aufrufen aus dem Internet den Zugriff auf die IsUserMemberOf-Methode. Stammt der Aufruf von einem URL wie "http://contoso/Beispiel.xsn", kommt er aus dem Intranet. Bei nicht vertrauenswürdigen Aufrufen aus dem Intranet überprüft InfoPath, ob die Benutzerauthentifizierungseinstellungen von Internet Explorer die automatische Anmeldung zulassen (entweder nur im Intranet oder bei jeder Anmeldung). Wenn Internet Explorer für die automatische Anmeldung konfiguriert ist, wird von InfoPath die Gruppenmitgliedschaft des Benutzers überprüft. Wenn die Gruppenmitgliedschaft öffentlich ist, ermöglicht InfoPath den Vollzugriff auf die IsUserMemberOf-Methode. Ist die Gruppenmitgliedschaft nicht vollständig öffentlich, blendet InfoPath das Ergebnis aus und behandelt die Gruppenmitgliedschaft so, als ob sie nicht sichtbar wäre. Der Rückgabewert ist in diesem Fall immer False, da die Gruppenmitgliedschaft nicht öffentlich ist, InfoPath meldet nicht, dass der Zugriff verweigert wurde.

Hinweis:
Die Informationen zur Gruppenmitgliedschaft sind vollständig öffentlich, wenn der Zugriff darauf möglich ist und die Informationen für alle nicht-anonymen Benutzer sichtbar sind. Selbst wenn nur einem einzigen nicht-anonymen Benutzer der Zugriff auf die Informationen zur Mitgliedschaft verweigert wurde, sind die Informationen zur Gruppenmitgliedschaft nicht vollständig öffentlich.

Beispiel

Im folgenden Beispiel wird die IsUserMemberOf-Methode des UserObject-Objekts verwendet, um zu bestimmen, ob der aktuelle Benutzer Mitglied der Gruppe "GroupDomain\Administrators" ist.

bool groupMatched;
groupMatched = thisApplication.User.IsUserMemberOf(@"GroupDomain\Administrators");

Siehe auch

Referenz

User2-Schnittstelle
User2-Member
Microsoft.Office.Interop.InfoPath-Namespace

Sdílet prostřednictvím