LOGINPROPERTY (Transact-SQL)

Retourne des informations sur les paramètres de stratégie de connexion.

Syntaxe

LOGINPROPERTY ( 'login_name' , 
                                    { 'IsLocked' | 'IsExpired' | 'IsMustChange'
                                    | 'BadPasswordCount' | 'BadPasswordTime' 
                                    | 'HistoryLength' | 'LockoutTime' 
                                    | 'PasswordLastSetTime' | 'PasswordHash' } 
                            )

Notes

Cette fonction intégrée retourne des informations sur les paramètres de stratégie de mots 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 2005 prises en charge, mais les autres propriétés ne sont disponibles que si SQL Server 2005 est en cours d'exécution sous Windows Server 2003 et que CHECK_POLICY et CHECK_EXPIRATION sont tous les deux activés.

Autorisations

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

Argument

  • login_name
    Nom d'une connexion SQL Server pour laquelle l'état des propriétés de connexion est retourné.
  • 'IsLocked'
    Retourne des informations qui indiquent si la connexion est verrouillée.
  • 'IsExpired'
    Retourne des informations qui indiquent si la connexion a expiré.
  • 'IsMustChange'
    Retourne des informations qui indiquent si la connexion doit modifier son mot de passe lors de l'établissement de la connexion suivante.
  • '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.
  • 'HistoryLength'
    Retourne la durée pendant laquelle la connexion à fait l'objet d'un suivi à l'aide du mécanisme d'application des stratégies de mot de passe.
  • '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é.
  • 'PasswordLastSetTime'
    Retourne la date à laquelle le mot de passe actuel a été défini.
  • 'PasswordHash'
    Retourne le hachage du mot de passe.

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.

Exemples

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

L'exemple suivant vérifie si la connexion SQL Server WillisJO doit modifier son mot de passe lorsqu'elle se connecte la fois suivante à une instance de SQL Server.

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

B. Vérification du verrouillage d'une connexion

L'exemple suivant vérifie si la connexion SQL Server SamirK est verrouillée.

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

Voir aussi

Référence

sys.server_principals (Transact-SQL)

Autres ressources

Stratégie de mot de passe

Aide et Informations

Assistance sur SQL Server 2005