LOGINPROPERTY (Transact-SQL)

Syntaxe

LOGINPROPERTY ( 'login_name' , 'property_name' )

Argument

• login_name.
  Nom d'une connexion SQL Server pour laquelle l'état des propriétés de connexion est retourné.

• propertyname
  Expression contenant les informations de propriété devant être retournées pour la connexion. L'argument propertyname peut prendre l'une des valeurs suivantes.

  Valeur	Description
  BadPasswordCount	Retourne le nombre de tentatives de connexion consécutives effectuées avec un mot de passe incorrect.
  BadPasswordTime	Retourne l'heure de la dernière tentative de connexion effectuée avec un mot de passe incorrect.
  DaysUntilExpiration	Retourne le nombre de jours avant l'expiration du mot de passe.
  DefaultDatabase	Retourne la base de données par défaut de la connexion SQL Server telle que stockée dans les métadonnées ou master si aucune base de données n'est spécifiée. Retourne NULL pour les utilisateurs fournis non-SQL Server ; par exemple, les utilisateurs authentifiés Windows.
  DefaultLanguage	Retourne la langue par défaut de connexion telle que stockée dans les métadonnées. Retourne NULL pour les utilisateurs fournis non-SQL Server, par exemple les utilisateurs authentifiés Windows.
  HistoryLength	Retourne la durée pendant laquelle la connexion a fait l'objet d'un suivi à l'aide du mécanisme d'application des stratégies de mot de passe.
  IsExpired	Retourne des informations qui indiquent si la connexion a expiré.
  IsLocked	Retourne des informations qui indiquent si la connexion est verrouillée.
  IsMustChange	Retourne des informations qui indiquent si la connexion doit modifier son mot de passe lors de l'établissement de la connexion suivante.
  LockoutTime	Retourne la date à laquelle la connexion SQL Server a été verrouillée en raison du dépassement du nombre de tentatives de connexion autorisé.
  PasswordHash	Retourne le hachage du mot de passe.
  PasswordLastSetTime	Retourne la date à laquelle le mot de passe actuel a été défini.

Valeur retournée

Le type de données dépend de la valeur demandée.

IsLocked, IsExpired et IsMustChange sont de type int.

• 1 si la connexion est dotée de l'état spécifié.

• 0 si la connexion n'est pas dotée de l'état spécifié.

BadPasswordCount est de type int.

BadPasswordTime, HistoryLength, LockoutTime et PasswordLastSetTime sont de type datetime.

PasswordHash est de type varbinary.

NULL si la connexion n'est pas une connexion SQL Server valide.

DaysUntilExpiration est de type int.

0 si la connexion a expiré ou si elle expirera le jour de l'interrogation.

-1 si la stratégie de sécurité locale dans Windows ne fait jamais expirer le mot de passe.

NULL si CHECK_POLICY ou CHECK_EXPIRATION a la valeur OFF pour une connexion, ou si le système d'exploitation ne prend pas en charge la stratégie de mot de passe.

Notes

Cette fonction intégrée retourne des informations sur les paramètres de stratégie de mot de passe d'une connexion SQL Server. Étant donné que les noms des propriétés ne respectent pas la casse, les noms de propriété tels que BadPasswordCount et badpasswordcount sont équivalents. Les valeurs des propriétés PasswordHash et PasswordLastSetTime sont disponibles sur toutes les configurations de SQL Server prises en charge, mais les autres propriétés ne sont disponibles que si SQL Server est en cours d'exécution sous Windows Server 2003 et que CHECK_POLICY et CHECK_EXPIRATION sont tous les deux activés. Pour plus d'informations, consultez Stratégie de mot de passe.

Autorisations

Requiert l'autorisation VIEW sur la connexion. Pour la demande du hachage de mot de passe, requiert en outre l'autorisation CONTROL SERVER.

Exemples

A. Détermination de la nécessité de modifier le mot de passe d'une connexion

SELECT LOGINPROPERTY('John3', 'IsMustChange');
GO

B. Vérification du verrouillage d'une connexion

SELECT LOGINPROPERTY('John3', 'IsLocked');
GO

Voir aussi

Référence

Concepts