Esta documentación está archivada y no tiene mantenimiento.

WindowsPrincipal.IsInRole (Método) (SecurityIdentifier)

Determina si el principal actual pertenece al grupo de usuarios de Windows con el identificador de seguridad (SID) especificado.

Espacio de nombres: System.Security.Principal
Ensamblado: mscorlib (en mscorlib.dll)

[ComVisibleAttribute(false)] 
public virtual bool IsInRole (
	SecurityIdentifier sid
)
/** @attribute ComVisibleAttribute(false) */ 
public boolean IsInRole (
	SecurityIdentifier sid
)
ComVisibleAttribute(false) 
public function IsInRole (
	sid : SecurityIdentifier
) : boolean
No aplicable.

Parámetros

sid

Clase SecurityIdentifier que identifica un grupo de usuarios de Windows de forma única.

Valor devuelto

Es true si el principal actual es un miembro del grupo de usuarios de Windows especificado; en caso contrario, es false.

Tipo de excepciónCondición

ArgumentNullException

El valor de sid es referencia null (Nothing en Visual Basic).

SecurityException

Windows devolvió un error de Win32.

La clase SecurityIdentifier identifica un usuario o grupo en implementaciones de Windows 2000, Windows Server y Windows XP de forma única.

NotaImportante:

El método IsInRole no devuelve ningún resultado en Windows 98 y Windows Millennium.

NotaNota:

In Windows Vista, User Account Control (UAC) determines the privileges of a user. If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. By default, you are in the standard user role. When you attempt to perform a task that requires administrative privileges, you can dynamically elevate your role by using the Consent dialog box. The code that executes the IsInRole method does not display the Consent dialog box. The code returns false if you are in the standard user role, even if you are in the Built-in Administrators group. You can elevate your privileges before you execute the code by right-clicking the application icon and indicating that you want to run as an administrator.

Cuando se prueba información de funciones recién creadas, como un nuevo usuario o un nuevo grupo, es importante cerrar sesión e iniciar sesión para forzar la propagación de la información de funciones dentro del dominio. De no hacerlo, puede que la prueba de IsInRole devuelva false.

Por motivos de rendimiento, ésta es la sobrecarga preferible para determinar la función de un usuario.

The following code example demonstrates the use of the WindowsPrincipal.IsInRole(SecurityIdentifier) method. The WellKnownSidTypeBuiltinAdministratorsSid is used to determine whether the current principal is an administrator. For the full code example, see the WindowsPrincipal.IsInRole(Int32) method.

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

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: