WindowsPrincipal.IsInRole Methode

public:
 virtual bool IsInRole(int rid);

public virtual bool IsInRole(int rid);

override this.IsInRole : int -> bool

abstract member IsInRole : int -> bool
override this.IsInRole : int -> bool

Public Overridable Function IsInRole (rid As Integer) As Boolean

Parameters

Retouren

true als de huidige principal lid is van de opgegeven Windows gebruikersgroep, die is, in een bepaalde rol; anders false.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de IsInRole methoden. De WindowsBuiltInRole opsomming wordt gebruikt als de bron voor de RID's die de ingebouwde rollen identificeren. De RID's worden gebruikt om de rollen van de huidige principal te bepalen.

public:
   static void DemonstrateWindowsBuiltInRoleEnum()
   {
      AppDomain^ myDomain = Thread::GetDomain();

      myDomain->SetPrincipalPolicy( PrincipalPolicy::WindowsPrincipal );
      WindowsPrincipal^ myPrincipal = dynamic_cast<WindowsPrincipal^>(Thread::CurrentPrincipal);

      Console::WriteLine( "{0} belongs to: ", myPrincipal->Identity->Name );

      Array^ wbirFields = Enum::GetValues( WindowsBuiltInRole::typeid );

      for each ( Object^ roleName in wbirFields )
      {
         try
         {
            Console::WriteLine( "{0}? {1}.", roleName,
               myPrincipal->IsInRole(  *dynamic_cast<WindowsBuiltInRole^>(roleName) ) );
         }
         catch ( Exception^ ) 
         {
            Console::WriteLine( "{0}: Could not obtain role for this RID.",
               roleName );
         }
      }
   }

using System;
using System.Threading;
using System.Security.Permissions;
using System.Security.Principal;

class SecurityPrincipalDemo
{
    public static void DemonstrateWindowsBuiltInRoleEnum()
    {
        AppDomain myDomain = Thread.GetDomain();

        myDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal);
        WindowsPrincipal myPrincipal = (WindowsPrincipal)Thread.CurrentPrincipal;
        Console.WriteLine("{0} belongs to: ", myPrincipal.Identity.Name.ToString());
        Array wbirFields = Enum.GetValues(typeof(WindowsBuiltInRole));
        foreach (object roleName in wbirFields)
        {
            try
            {
                // Cast the role name to a RID represented by the WindowsBuildInRole value.
                Console.WriteLine("{0}? {1}.", roleName,
                    myPrincipal.IsInRole((WindowsBuiltInRole)roleName));
                Console.WriteLine("The RID for this role is: " + ((int)roleName).ToString());
            }
            catch (Exception)
            {
                Console.WriteLine("{0}: Could not obtain role for this RID.",
                    roleName);
            }
        }
        // Get the role using the string value of the role.
        Console.WriteLine("{0}? {1}.", "Administrators",
            myPrincipal.IsInRole("BUILTIN\\" + "Administrators"));
        Console.WriteLine("{0}? {1}.", "Users",
            myPrincipal.IsInRole("BUILTIN\\" + "Users"));
        // Get the role using the WindowsBuiltInRole enumeration value.
        Console.WriteLine("{0}? {1}.", WindowsBuiltInRole.Administrator,
           myPrincipal.IsInRole(WindowsBuiltInRole.Administrator));
        // Get the role using the WellKnownSidType.
        SecurityIdentifier sid = new SecurityIdentifier(WellKnownSidType.BuiltinAdministratorsSid, null);
        Console.WriteLine("WellKnownSidType BuiltinAdministratorsSid  {0}? {1}.", sid.Value, myPrincipal.IsInRole(sid));
    }

    public static void Main()
    {
        DemonstrateWindowsBuiltInRoleEnum();
    }
}

Imports System.Threading
Imports System.Security.Permissions
Imports System.Security.Principal

Class SecurityPrincipalDemo

    Public Shared Sub DemonstrateWindowsBuiltInRoleEnum()
        Dim myDomain As AppDomain = Thread.GetDomain()

        myDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal)
        Dim myPrincipal As WindowsPrincipal = CType(Thread.CurrentPrincipal, WindowsPrincipal)
        Console.WriteLine("{0} belongs to: ", myPrincipal.Identity.Name.ToString())
        Dim wbirFields As Array = [Enum].GetValues(GetType(WindowsBuiltInRole))
        Dim roleName As Object
        For Each roleName In wbirFields
            Try
                ' Cast the role name to a RID represented by the WindowsBuildInRole value.
                Console.WriteLine("{0}? {1}.", roleName, myPrincipal.IsInRole(CType(roleName, WindowsBuiltInRole)))
                Console.WriteLine("The RID for this role is: " + Fix(roleName).ToString())

            Catch
                Console.WriteLine("{0}: Could not obtain role for this RID.", roleName)
            End Try
        Next roleName
        ' Get the role using the string value of the role.
        Console.WriteLine("{0}? {1}.", "Administrators", myPrincipal.IsInRole("BUILTIN\" + "Administrators"))
        Console.WriteLine("{0}? {1}.", "Users", myPrincipal.IsInRole("BUILTIN\" + "Users"))
        ' Get the role using the WindowsBuiltInRole enumeration value.
        Console.WriteLine("{0}? {1}.", WindowsBuiltInRole.Administrator, myPrincipal.IsInRole(WindowsBuiltInRole.Administrator))
        ' Get the role using the WellKnownSidType.
        Dim sid As New SecurityIdentifier(WellKnownSidType.BuiltinAdministratorsSid, Nothing)
        Console.WriteLine("WellKnownSidType BuiltinAdministratorsSid  {0}? {1}.", sid.Value, myPrincipal.IsInRole(sid))

    End Sub

    Public Shared Sub Main()
        DemonstrateWindowsBuiltInRoleEnum()

    End Sub
End Class

Opmerkingen

Bij het testen van nieuw gemaakte rolgegevens, zoals een nieuwe gebruiker of een nieuwe groep, is het belangrijk om u af te melden en aan te melden om de doorgifte van rolgegevens binnen het domein af te dwingen. Als u dit niet doet, kan de IsInRole test worden geretourneerd false.

Om prestatieredenen wordt de IsInRole(SecurityIdentifier) overbelasting aanbevolen als de voorkeursoverbelasting voor het bepalen van de rol van de gebruiker.

Relatieve id's (RID's) zijn onderdelen van een Windows beveiligings-id (SID) van een gebruikersgroep en worden ondersteund om problemen met platformoverschrijdende lokalisatie te voorkomen. Veel gebruikersaccounts, lokale groepen en globale groepen hebben een standaard RID-waarde die constant is in alle versies van Windows.

De RID voor de rol BUILTIN\Administrators is bijvoorbeeld 0x220. Als u 0x220 gebruikt als invoerparameter voor de IsInRole methode, wordt true deze geretourneerd als de huidige principal een beheerder is.

De volgende tabellen bevatten de standaard RID-waarden.

public:
 virtual bool IsInRole(System::Security::Principal::SecurityIdentifier ^ sid);

public virtual bool IsInRole(System.Security.Principal.SecurityIdentifier sid);

[System.Runtime.InteropServices.ComVisible(false)]
public virtual bool IsInRole(System.Security.Principal.SecurityIdentifier sid);

override this.IsInRole : System.Security.Principal.SecurityIdentifier -> bool

[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member IsInRole : System.Security.Principal.SecurityIdentifier -> bool
override this.IsInRole : System.Security.Principal.SecurityIdentifier -> bool

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.IsInRole : System.Security.Principal.SecurityIdentifier -> bool

Public Overridable Function IsInRole (sid As SecurityIdentifier) As Boolean

Parameters

Retouren

true als de huidige principal lid is van de opgegeven Windows gebruikersgroep; anders false.

Kenmerken

ComVisibleAttribute

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de WindowsPrincipal.IsInRole(SecurityIdentifier) methode. De BuiltinAdministratorsSid opsommingswaarde wordt gebruikt om te bepalen of de huidige principal een beheerder is. Zie de WindowsPrincipal.IsInRole(Int32) methode voor het volledige codevoorbeeld.

// Get the role using the WellKnownSidType.
SecurityIdentifier sid = new SecurityIdentifier(WellKnownSidType.BuiltinAdministratorsSid, null);
Console.WriteLine("WellKnownSidType BuiltinAdministratorsSid  {0}? {1}.", sid.Value, myPrincipal.IsInRole(sid));

    ' Get the role using the WellKnownSidType.
    Dim sid As New SecurityIdentifier(WellKnownSidType.BuiltinAdministratorsSid, Nothing)
    Console.WriteLine("WellKnownSidType BuiltinAdministratorsSid  {0}? {1}.", sid.Value, myPrincipal.IsInRole(sid))

End Sub

Opmerkingen

De SecurityIdentifier identificeert een gebruiker of groep op unieke wijze op Windows. Bij het testen van nieuw gemaakte rolgegevens, zoals een nieuwe gebruiker of een nieuwe groep, is het belangrijk om u af te melden en aan te melden om de doorgifte van rolgegevens binnen het domein af te dwingen. Als u dit niet doet, kan de IsInRole test worden geretourneerd false.

Om prestatieredenen is dit de voorkeur aan overbelasting om de rol van een gebruiker te bepalen.

public:
 virtual bool IsInRole(System::Security::Principal::WindowsBuiltInRole role);

public virtual bool IsInRole(System.Security.Principal.WindowsBuiltInRole role);

override this.IsInRole : System.Security.Principal.WindowsBuiltInRole -> bool

abstract member IsInRole : System.Security.Principal.WindowsBuiltInRole -> bool
override this.IsInRole : System.Security.Principal.WindowsBuiltInRole -> bool

Public Overridable Function IsInRole (role As WindowsBuiltInRole) As Boolean

Parameters

Retouren

true als de huidige principal lid is van de opgegeven Windows gebruikersgroep; anders false.

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt de WindowsBuiltInRole opsomming gebruikt om te bepalen of de huidige principal een Administratoris. Zie de WindowsPrincipal.IsInRole(Int32) methode voor het volledige codevoorbeeld.

// Get the role using the WindowsBuiltInRole enumeration value.
Console.WriteLine("{0}? {1}.", WindowsBuiltInRole.Administrator,
   myPrincipal.IsInRole(WindowsBuiltInRole.Administrator));

' Get the role using the WindowsBuiltInRole enumeration value.
Console.WriteLine("{0}? {1}.", WindowsBuiltInRole.Administrator, myPrincipal.IsInRole(WindowsBuiltInRole.Administrator))

Opmerkingen

Bij het testen van nieuw gemaakte rolgegevens, zoals een nieuwe gebruiker of een nieuwe groep, is het belangrijk om u af te melden en aan te melden om de doorgifte van rolgegevens binnen het domein af te dwingen. Als u dit niet doet, kan de IsInRole test worden geretourneerd false.

Om prestatieredenen wordt de IsInRole(SecurityIdentifier) overbelasting aanbevolen als de voorkeursoverbelasting voor het bepalen van de rol van de gebruiker.

public:
 override bool IsInRole(System::String ^ role);

public:
 virtual bool IsInRole(System::String ^ role);

public override bool IsInRole(string role);

public virtual bool IsInRole(string role);

override this.IsInRole : string -> bool

abstract member IsInRole : string -> bool
override this.IsInRole : string -> bool

Public Overrides Function IsInRole (role As String) As Boolean

Public Overridable Function IsInRole (role As String) As Boolean

Parameters

Retouren

true als de huidige principal lid is van de opgegeven Windows gebruikersgroep; anders false.

Implementeringen

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de WindowsPrincipal.IsInRole(String) methode.

De tekenreeksen BUILTIN\Administrators en BUILTIN\Users worden gebruikt om te bepalen of de huidige principal een beheerder of gebruiker is. Zie de WindowsPrincipal.IsInRole(Int32) methode voor het volledige codevoorbeeld.

// Get the role using the string value of the role.
Console.WriteLine("{0}? {1}.", "Administrators",
    myPrincipal.IsInRole("BUILTIN\\" + "Administrators"));
Console.WriteLine("{0}? {1}.", "Users",
    myPrincipal.IsInRole("BUILTIN\\" + "Users"));

' Get the role using the string value of the role.
Console.WriteLine("{0}? {1}.", "Administrators", myPrincipal.IsInRole("BUILTIN\" + "Administrators"))
Console.WriteLine("{0}? {1}.", "Users", myPrincipal.IsInRole("BUILTIN\" + "Users"))

Opmerkingen

Bij het testen van nieuw gemaakte rolgegevens, zoals een nieuwe gebruiker of een nieuwe groep, is het belangrijk om u af te melden en aan te melden om de doorgifte van rolgegevens binnen het domein af te dwingen. Als u dit niet doet, kan de IsInRole test worden geretourneerd false.

Om prestatieredenen wordt de IsInRole(SecurityIdentifier) overbelasting aanbevolen als de voorkeursoverbelasting voor het bepalen van de rol van de gebruiker.

Voor ingebouwde rollen moet de role tekenreeks de vorm 'BUILTIN\RoleNameHere' hebben. Als u bijvoorbeeld wilt testen op lidmaatschap van de Windows beheerdersrol, moet de tekenreeks voor de rol 'BUILTIN\Administrators' zijn. Houd er rekening mee dat de backslash mogelijk moet worden ontsnapt. De volgende tabel bevat de ingebouwde rollen.

Voor computerspecifieke rollen moet de role tekenreeks de notatie MachineName\RoleNameHere hebben.

Voor domeinspecifieke rollen moet de role tekenreeks de notatie DomainName\RoleNameHere hebben, bijvoorbeeld "SomeDomain\Domain Users'.

Zie ook

• WindowsBuiltInRole