LOGINPROPERTY (Transact-SQL)

Articolo
12/15/2008

Restituisce informazioni sulle impostazioni relative ai criteri di gestione degli account di accesso.

Sintassi

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

Argomenti

login_name
Nome di un account di accesso di SQL Server per cui verrà restituito lo stato delle proprietà di accesso.

'IsLocked'
Restituisce informazioni che indicano se l'account di accesso è bloccato.

'IsExpired'
Restituisce informazioni che indicano se l'account di accesso è scaduto.

'IsMustChange'
Restituisce informazioni che indicano se la password dell'account di accesso deve essere modificata alla connessione successiva.

'BadPasswordCount'
Restituisce il numero di tentativi consecutivi di accesso con una password non corretta.

'BadPasswordTime'
Restituisce l'ora dell'ultimo tentativo di accesso con password non corretta.

'HistoryLength'
Restituisce la durata del rilevamento dell'account di accesso utilizzando il meccanismo di applicazione dei criteri di gestione delle password.

'LockoutTime'
Restituisce la data di blocco dell'account di accesso di SQL Server a causa del superamento del numero consentito di tentativi di accesso non riusciti.

'PasswordLastSetTime'
Restituisce la data di impostazione della password corrente.

'PasswordHash'
Restituisce l'hash della password.

Osservazioni

Questa funzione predefinita restituisce informazioni sulle impostazioni relative ai criteri di gestione delle password per un account di accesso di SQL Server. Poiché i nomi delle proprietà non supportano la distinzione tra maiuscole e minuscole, BadPasswordCount e badpasswordcount sono equivalenti. I valori delle proprietà PasswordHash e PasswordLastSetTime sono disponibili in tutte le configurazioni supportate di SQL Server 2005, mentre le altre proprietà sono disponibili solo se SQL Server 2005 è in esecuzione in Windows Server 2003 e se sono attivate sia CHECK_POLICY che CHECK_EXPIRATION.

Autorizzazioni

È richiesta l'autorizzazione VIEW per l'account di accesso. Se si richiede l'hash della password, è inoltre richiesta l'autorizzazione CONTROL SERVER.

Restituisce

Il tipo di dati dipende dal valore richiesto.

IsLocked, IsExpired e IsMustChange sono di tipo int.

1 se l'account di accesso si trova nello stato specificato.
0 se l'account di accesso non si trova nello stato specificato.

BadPasswordCount è di tipo int.

BadPasswordTime, HistoryLength, LockoutTime, PasswordLastSetTime sono di tipo datetime.

PasswordHash è di tipo varbinary.

NULL se l'account di accesso non è un account di accesso di SQL Server valido.

Esempi

A. Verifica della necessità di modificare la password di un account di accesso

Nell'esempio seguente viene controllato se la password dell'account di accesso WillisJO di SQL Server deve essere modificata alla connessione successiva a un'istanza di SQL Server.

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

B. Controllo dell'eventuale blocco di un account di accesso

Nell'esempio seguente viene controllato se l'account di accesso SamirK di SQL Server è bloccato.

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

Vedere anche