xp_logininfo (Transact-SQL)

Retourne des informations sur les utilisateurs Windows et les groupes Windows.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

• [ @acctname = ] 'account_name'
  Nom d'un utilisateur ou groupe Windows autorisé à accéder à SQL Server. Le paramètre account_name est de type sysname, avec NULL comme valeur par défaut. Si aucun paramètre account_name n'est indiqué, tous les groupes et utilisateurs Windows qui ont explicitement reçu l'autorisation de se connecter sont signalés. Le nom complet du paramètre account_name doit être spécifié. Par exemple, « ADVWKS4\macraes » ou « BUILTIN\Administrators ».

• 'all' | 'members'
  Spécifie s'il faut rapporter les informations sur tous les chemins d'autorisation du compte ou sur les membres du groupe Windows. @option est de type varchar(10), avec NULL comme valeur par défaut. Excepté si all est spécifié, seul le premier chemin d'autorisation est affiché.

• [ @privilege = ] variable_name
  Paramètre de sortie qui retourne le niveau de privilège du compte Windows spécifié. Le paramètre variable_name est de type varchar(10). Sa valeur par défaut est « Not wanted ». Le niveau de privilège renvoyé peut être user, admin ou null.

• OUTPUT
  Place la valeur de variable_name dans le paramètre de sortie.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

Si le paramètre account_name est spécifié, xp_logininfo indique le niveau de privilège le plus élevé du groupe ou de l'utilisateur Windows spécifié. Si un utilisateur Windows dispose d'autorisations d'accès en tant qu'administrateur système et utilisateur de domaine, il est indiqué comme administrateur système. Si l'utilisateur est membre de plusieurs groupes Windows dotés des mêmes niveaux de privilèges, seul le groupe qui a obtenu le premier l'accès à SQL Server est indiqué.

Si le paramètre account_name est un utilisateur ou un groupe Windows valide qui n'est pas associé à une connexion SQL Server, un ensemble de résultats vide est retourné. Si account_name ne peut pas être identifié en tant que groupe ou utilisateur Windows valide, un message d'erreur est retourné.

Si account_name et all sont spécifiés, tous les chemins d'autorisation du groupe ou de l'utilisateur Windows sont retournés. Si account_name est membre de plusieurs groupes qui ont tous reçu l'autorisation d'accéder à SQL Server, plusieurs lignes sont retournées. Les lignes avec le privilège admin sont retournées avant celles avec le privilège utilisateur, et à l'intérieur d'un même niveau de privilège, les lignes sont retournées selon l'ordre de création des connexions SQL Server correspondantes.

Si account_name et members sont spécifiés, la liste des membres du niveau suivant du groupe est retournée. Si account_name est un groupe local, la liste peut inclure des utilisateurs locaux, des utilisateurs de domaine et des groupes. Si account_name est un compte de domaine, la liste est composée d'utilisateurs de domaine. SQL Server doit se connecter au contrôleur de domaine pour extraire les informations d'appartenance au groupe. Si le serveur ne peut pas contacter le contrôleur de domaine, aucune information n'est renvoyée.

Autorisations

Requiert l'appartenance au rôle de serveur fixe sysadmin ou l'appartenance au rôle de base de données fixe public dans la base de données master avec l'autorisation EXECUTE accordée.

Ensembles de résultats

Exemples

L'exemple suivant affiche des informations sur le groupe Windows BUILTIN\Administrators.

EXEC xp_logininfo 'BUILTIN\Administrators'

Voir aussi

Référence

sp_denylogin (Transact-SQL)
sp_grantlogin (Transact-SQL)
sp_revokelogin (Transact-SQL)
Procédures stockées système (Transact-SQL)
Procédures stockées étendues générales (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005