WindowsPrincipal.IsInRole Metoda

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

Parametry

Návraty

truepokud je aktuální objekt zabezpečení členem zadané skupiny uživatelů systému Windows, to znamená v určité roli; v opačném případě . false

Příklady

Následující příklad kódu ukazuje použití IsInRole metod. Výčet se WindowsBuiltInRole používá jako zdroj pro identifikátory RID, které identifikují předdefinované role. Identifikátory RID se používají k určení rolí aktuálního objektu zabezpečení.

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

Poznámky

Při testování nově vytvořených informací o rolích, jako je například nový uživatel nebo nová skupina, je důležité se odhlásit a přihlásit, aby se vynutil šíření informací o rolích v rámci domény. Pokud to neuděláte, může IsInRole test vrátit false.

Z důvodů výkonu IsInRole(SecurityIdentifier) se přetížení doporučuje jako vhodnější přetížení pro určení role uživatele.

Relativní identifikátory (RID) jsou součásti identifikátoru zabezpečení skupiny uživatelů systému Windows a podporují se, aby se zabránilo problémům s lokalizací napříč platformami. Mnoho uživatelských účtů, místních skupin a globálních skupin má výchozí hodnotu RID, která je konstantní ve všech verzích Windows.

Například identifikátor RID pro roli BUILTIN\Administrators je 0x220. Použití 0x220 jako vstupního parametru pro metodu IsInRole má za následek true vrácení, pokud je aktuálním objektem zabezpečení správce.

V následujících tabulkách jsou uvedeny výchozí hodnoty RID.

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

Parametry

Návraty

truepokud je aktuální objekt zabezpečení členem zadané skupiny uživatelů systému Windows; v opačném případě . false

Atributy

ComVisibleAttribute

Výjimky

Příklady

Následující příklad kódu ukazuje použití WindowsPrincipal.IsInRole(SecurityIdentifier) metody. Hodnota BuiltinAdministratorsSid výčtu se používá k určení, jestli je aktuálním objektem zabezpečení správce. Úplný příklad kódu najdete v WindowsPrincipal.IsInRole(Int32) metodě.

// 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

Poznámky

Jedinečně SecurityIdentifier identifikuje uživatele nebo skupinu ve Windows. Při testování nově vytvořených informací o rolích, jako je například nový uživatel nebo nová skupina, je důležité se odhlásit a přihlásit, aby se vynutil šíření informací o rolích v rámci domény. Pokud to neuděláte, může IsInRole test vrátit false.

Z důvodů výkonu se jedná o vhodnější přetížení pro určení role uživatele.

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

Parametry

Návraty

truePokud je aktuální objekt zabezpečení členem zadané skupiny uživatelů systému Windows; v opačném případě . false

Výjimky

Příklady

Následující příklad používá WindowsBuiltInRole výčet, který se používá k určení, jestli je aktuální objekt zabezpečení .Administrator Úplný příklad kódu najdete v WindowsPrincipal.IsInRole(Int32) metodě.

// 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))

Poznámky

Při testování nově vytvořených informací o rolích, jako je například nový uživatel nebo nová skupina, je důležité se odhlásit a přihlásit, aby se vynutil šíření informací o rolích v rámci domény. Pokud to neuděláte, může IsInRole test vrátit false.

Z důvodů výkonu IsInRole(SecurityIdentifier) se přetížení doporučuje jako vhodnější přetížení pro určení role uživatele.

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

Parametry

Návraty

truePokud je aktuální objekt zabezpečení členem zadané skupiny uživatelů systému Windows; v opačném případě . false

Implementuje

Příklady

Následující příklad kódu ukazuje použití WindowsPrincipal.IsInRole(String) metody .

Řetězce BUILTIN\Administrators a BUILTIN\Users slouží k určení, jestli je aktuálním objektem zabezpečení správce nebo uživatel. Úplný příklad kódu najdete v WindowsPrincipal.IsInRole(Int32) metodě .

// 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"))

Poznámky

Při testování nově vytvořených informací o rolích, jako je nový uživatel nebo nová skupina, je důležité se odhlásit a přihlásit, aby se vynutil šíření informací o rolích v rámci domény. Pokud to neuděláte, může IsInRole test vrátit false.

Z důvodů výkonu IsInRole(SecurityIdentifier) se přetížení doporučuje jako nejvhodnější přetížení pro určení role uživatele.

U předdefinovaných rolí role by řetězec měl být ve formátu BUILTIN\RoleNameHere. Pokud například chcete otestovat členství v roli správce systému Windows, řetězec představující roli by měl být BUILTIN\Administrators. Všimněte si, že zpětné lomítko může být potřeba udát řídicím znakem. Následující tabulka uvádí předdefinované role.

U rolí role specifických pro počítač by měl být řetězec ve formátu MachineName\RoleNameHere.

U rolí role specifických pro doménu by měl být řetězec ve formátu DomainName\RoleNameHere, "SomeDomain\Domain Usersnapříklad .

Viz také

• WindowsBuiltInRole