WindowsPrincipal.IsInRole Método

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

Parâmetros

Devoluções

true se o principal atual for membro do grupo de utilizadores Windows especificado, ou seja, num determinado papel; caso contrário, false.

Exemplos

O seguinte exemplo de código demonstra a utilização dos IsInRole métodos. A WindowsBuiltInRole enumeração é usada como fonte para os RIDs que identificam os papéis incorporados. Os RIDs são usados para determinar os papéis do atual diretor.

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

Observações

Ao testar informação de função recém-criada, como um novo utilizador ou um novo grupo, é importante sair e iniciar sessão para forçar a propagação da informação de função dentro do domínio. Não o fazer pode fazer com que o IsInRole teste volte falsea aparecer.

Por razões de desempenho, a IsInRole(SecurityIdentifier) sobrecarga é recomendada como a sobrecarga preferida para determinar o papel do utilizador.

Os identificadores relativos (RIDs) são componentes do identificador de segurança (SID) de um grupo de utilizadores do Windows e são suportados para ajudar a prevenir problemas de localização entre plataformas. Muitas contas de utilizador, grupos locais e grupos globais têm um valor RID predefinido que é constante em todas as versões do Windows.

Por exemplo, o RID para o papel BUILTIN\Administrators é 0x220. Usar 0x220 como parâmetro de entrada para o IsInRole método resulta em true ser devolvido se o principal atual for um administrador.

As tabelas seguintes listam os valores RID predefinidos.

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

Parâmetros

Devoluções

true se o principal atual for membro do grupo de utilizadores Windows especificado; caso contrário, false.

Atributos

ComVisibleAttribute

Exceções

Exemplos

O exemplo de código seguinte demonstra a utilização do WindowsPrincipal.IsInRole(SecurityIdentifier) método. O BuiltinAdministratorsSid valor de enumeração é usado para determinar se o principal atual é um administrador. Para o exemplo completo do código, veja o WindowsPrincipal.IsInRole(Int32) método.

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

Observações

O SecurityIdentifier identifica de forma única um utilizador ou grupo no Windows. Ao testar informação de função recém-criada, como um novo utilizador ou um novo grupo, é importante sair e iniciar sessão para forçar a propagação da informação de função dentro do domínio. Não o fazer pode fazer com que o IsInRole teste volte falsea aparecer.

Por razões de desempenho, esta é a sobrecarga preferível para determinar o papel do utilizador.

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

Parâmetros

Devoluções

true se o principal atual for membro do grupo de utilizadores Windows especificado; caso contrário, false.

Exceções

Exemplos

O exemplo seguinte utiliza a WindowsBuiltInRole enumeração para determinar se o principal atual é um Administrator. Para o exemplo completo do código, veja o WindowsPrincipal.IsInRole(Int32) método.

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

Observações

Ao testar informação de função recém-criada, como um novo utilizador ou um novo grupo, é importante sair e iniciar sessão para forçar a propagação da informação de função dentro do domínio. Não o fazer pode fazer com que o IsInRole teste volte falsea aparecer.

Por razões de desempenho, a IsInRole(SecurityIdentifier) sobrecarga é recomendada como a sobrecarga preferida para determinar o papel do utilizador.

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

Parâmetros

Devoluções

true se o principal atual for membro do grupo de utilizadores Windows especificado; caso contrário, false.

Implementações

Exemplos

O exemplo de código seguinte demonstra a utilização do WindowsPrincipal.IsInRole(String) método.

As cadeias BUILTIN\Administrators e BUILTIN\Users são usadas para determinar se o principal atual é um administrador ou um utilizador. Para o exemplo completo do código, veja o WindowsPrincipal.IsInRole(Int32) método.

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

Observações

Ao testar informação de função recém-criada, como um novo utilizador ou um novo grupo, é importante sair e iniciar sessão para forçar a propagação da informação de função dentro do domínio. Não o fazer pode fazer com que o IsInRole teste volte falsea aparecer.

Por razões de desempenho, a IsInRole(SecurityIdentifier) sobrecarga é recomendada como a sobrecarga preferida para determinar o papel do utilizador.

Para papéis incorporados, a role string deve ter a forma "BUILTIN\RoleNameHere". Por exemplo, para testar a pertença ao papel de administrador do Windows, a cadeia que representa o papel deve ser "BUILTIN\Administrators". Note que a barra transversal pode precisar de ser evitada. A tabela seguinte lista os papéis incorporados.

Para funções específicas de máquina, a role cadeia deve ter a forma "NomeMáquina\NomeAqui".

Para funções específicas de domínio, a role cadeia deve ter a forma "DomainName\RoleNameHere"; por exemplo, "SomeDomain\Domain Users".

Ver também

• WindowsBuiltInRole