xp_logininfo (Transact-SQL)

Devuelve información sobre usuarios y grupos de Windows.

Se aplica a: SQL Server (SQL Server 2008 a través de la versión actual).

Convenciones de sintaxis de Transact-SQL

Sintaxis

xp_logininfo [ [ @acctname = ] 'account_name' ] 
     [ , [ @option = ] 'all' | 'members' ] 
     [ , [ @privilege = ] variable_name OUTPUT]

Argumentos

• [ @acctname = ] 'account_name'
  Es el nombre de un usuario o grupo de Windows al que se ha concedido acceso a SQL Server. account_name es de tipo sysname y su valor predeterminado es NULL. Si no se especifica account_name, se notifica a todos los grupos y usuarios de Windows a los que se haya concedido explícitamente permiso de inicio de sesión. account_name debe ser un nombre completo. Por ejemplo, 'ADVWKS4\macraes' o 'BUILTIN\Administrators'.

• 'all' | 'members'
  Especifica si se presenta información de todas las rutas de acceso a permisos de la cuenta o si se presenta información de los miembros del grupo de Windows. @option es de tipo varchar(10) y su valor predeterminado es NULL. A menos que se especifique all, solo se presenta la primera ruta de permisos.

• [ @privilege = ] variable_name
  Es un parámetro de salida que devuelve el nivel de privilegio de la cuenta de Windows especificada. variable_name es de tipo varchar(10) y su valor predeterminado es 'Not wanted' (no deseado). El nivel de privilegio devuelto es user, admin o null.

• OUTPUT
  Si se especifica, coloca variable_name en el parámetro de salida.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de columna	Tipo de datos	Descripción
account name	sysname	Nombre completo de la cuenta de Windows.
tipo	char(8)	Tipo de cuenta de Windows. Los valores válidos son user o group.
privilege	char(9)	Privilegio de acceso para SQL Server. Los valores válidos son admin, user o null.
mapped login name	sysname	Para las cuentas de usuario con privilegios de usuario, mapped login name muestra el nombre del inicio de sesión asociado que SQL Server utiliza cuando se inicia la sesión con esta cuenta, utilizando las reglas de asociación con el nombre de dominio agregado antes del nombre de la cuenta.
permission path	sysname	Pertenencia al grupo que permite que la cuenta tenga acceso.

Comentarios

Si se especifica account_name , xp_logininfo notifica el mayor nivel de privilegio del usuario o grupo de Windows especificado. Si un usuario de Windows tiene acceso como administrador del sistema y como usuario del dominio, se le notificará como administrador del sistema. Si el usuario es miembro de varios grupos de Windows del mismo nivel de privilegio, solo se le notificará en el grupo al que se concediera primero acceso a SQL Server.

Si account_name es un usuario o grupo de Windows válido que no está asociado a un inicio de sesión de SQL Server, se devuelve un conjunto de resultados vacío. Si no se puede identificar account_name como un usuario o grupo de Windows válido, se devuelve un mensaje de error.

Si se especifican account_name y all, se devuelven todas las rutas de permisos para el usuario o grupo de Windows. Si account_name es miembro de varios grupos a los que se ha concedido acceso a SQL Server, se devuelven varias filas. Se devuelven las filas del privilegio admin antes que las filas del privilegio user y, dentro de un mismo nivel de privilegio, se devuelven las filas en el orden de creación de los inicios de sesión de SQL Server correspondientes.

Si se especifican account_name y members, se devuelve la lista de los miembros del grupo del siguiente nivel. Si account_name es un grupo local, la lista puede incluir usuarios locales, usuarios del dominio y grupos. Si account_name es una cuenta de dominio, la lista está formada por usuarios del dominio. SQL Server debe conectarse al controlador de dominio para recuperar la información de pertenencia a grupos. Si el servidor no puede contactar con el controlador de dominio, no se obtendrá ninguna información.

xp_logininfo solamente devuelve información de los grupos globales de Active Directory y no de los grupos universales.

Permisos

Requiere la pertenencia al rol fijo de servidor sysadmin o al rol fijo de base de datos public en la base de datos master con permiso EXECUTE concedido.

Ejemplos

En el ejemplo siguiente se muestra información sobre el grupo de Windows BUILTIN\Administrators.

EXEC xp_logininfo 'BUILTIN\Administrators';

Vea también

Referencia

sp_denylogin (Transact-SQL)

sp_grantlogin (Transact-SQL)

sp_revokelogin (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)

Procedimientos almacenados extendidos generales (Transact-SQL)