LOGINPROPERTY (Transact-SQL)

Retorna informações sobre configurações de diretiva de logon.

Convenções de sintaxe Transact-SQL

Sintaxe

LOGINPROPERTY ( 'login_name' , 'property_name' )

Argumentos

• login_name.
  É o nome de um logon do SQL Server para o qual o status de propriedade de logon será retornado.

• propertyname
  É uma expressão que contém as informações de propriedade a serem retornadas para o logon. propertyname pode ser um dos valores a seguir.

  Valor	Descrição
  BadPasswordCount	Retorna o número de tentativas consecutivas de fazer logon com uma senha incorreta.
  BadPasswordTime	Retorna a hora da última tentativa de fazer logon com uma senha incorreta.
  DaysUntilExpiration	Retorna o número de dias para que a senha expire.
  DefaultDatabase	Retorna o banco de dados padrão do logon do SQL Server como armazenado em metadados ou o mestre se nenhum banco de dados for especificado. Retorna NULL para usuários provisionados não-SQL Server; por exemplo usuários autenticados do Windows.
  DefaultLanguage	Retorna a linguagem padrão de logon como armazenado em metadados. Retorna NULL para usuários provisionados não-SQL Server, por exemplo usuários autenticados do Windows.
  HistoryLength	Retorna o comprimento de hora que o logon que tem controlado usando o mecanismo de imposição de diretiva de senha.
  IsExpired	Retorna informações que indicarão se o logon está expirou.
  IsLocked	Retorna informações que indicarão se o logon está bloqueado.
  IsMustChange	Retorna informações que indicarão se o logon deve alterar sua senha na próxima vez conectar.
  LockoutTime	Retorna a data em que o logon no SQL Server foi bloqueado porque excedeu o número permitido de tentativas de logon com falha.
  PasswordHash	Retorna o hash da senha.
  PasswordLastSetTime	Retorna a data em que a senha atual foi definida.

Retorna

O tipo de dado depende do valor solicitado.

IsLocked, IsExpirede IsMustChange são do tipo int.

• 1 se o logon estiver no estado especificado.

• 0 se o logon não estiver no estado especificado.

BadPasswordCount é do tipo int.

BadPasswordTime, HistoryLength, LockoutTime, que PasswordLastSetTime são do tipo datetime.

PasswordHash é do tipo varbinary.

NULL se o logon não for um logon válido do SQL Server.

DaysUntilExpiration é do tipo int.

0 se o logon estiver expirado ou se for expira no dia da consulta.

-1 se a diretiva de segurança local no Windows nunca expirar a senha.

NULL, se CHECK_POLICY ou CHECK_EXPIRATION for OFF para um logon ou se o sistema operacional não oferecer suporte à diretiva de senha.

Comentários

Essa função interna retorna informações sobre as configurações de diretiva de senha de um logon do SQL Server. Os nomes das propriedades não diferenciam maiúsculas e minúsculas, sendo assim, nomes de propriedade como BadPasswordCount e badpasswordcount são equivalentes. Os valores das propriedades PasswordHash e PasswordLastSetTime estão disponíveis em todas as configurações suportadas do SQL Server, porém outras estarão disponíveis apenas se o SQL Server for executado no Windows Server 2003 e tanto CHECK_POLICY como CHECK_EXPIRATION estiverem habilitadas. Para obter mais informações, consulte Diretiva de senha.

Permissões

Requer permissão VIEW para o logon. Ao solicitar o hash de senha, também requer a permissão CONTROL SERVER.

Exemplos

A. Verificando se um logon deve alterar sua senha

O exemplo a seguir verifica se o logon John3 do SQL Server deve alterar sua senha na próxima vez que se conectar a uma instância do SQL Server.

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

B. Verificando se um logon está bloqueado

O exemplo a seguir verifica se o logon John3 do SQL Server está bloqueado.

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

Consulte também

Referência

CREATE LOGIN (Transact-SQL)

sys.server_principals (Transact-SQL)

Conceitos

Controle de identidade e acesso (Mecanismo de banco de Dados)