Saltar para o conteúdo principal
Versão: Próximo

GET USER PROPERTIES

GET USER PROPERTIES ( refUsuario ; nome ; inicio ; senha ; numLogin ; ultLogin {; adesao {; propGrupo}} )

ParâmetroTipoDescrição
refUsuarioIntegerNº de referência de usuário
nomeTextNome de usuário
inicioTextNome de método de início
senhaTextSempre é uma cadeia vazia
numLoginIntegerNúmero de logins para o banco de dados
ultLoginDateData do último login ao banco de dados
adesaoInteger arrayNúmero de ID dos grupos ao qual o usuário pertence
propGrupoIntegerNúmero de ID do proprietário do grupo

Esse comando não é seguro para thread e não pode ser usado em código adequado.

Descrição

GET USER PROPERTIES retorna a informação sobre o usuário cujo número de referência se passa no parâmetro refUsuario. Deve passar um número de referência de usuário retornado pelo comando GET USER LIST.

Se a conta de usuário não existir ou tiver sido apagada, se gera o erro -9979. Pode interceptar este erro com um método de gestão de erros instalado por ON ERR CALL. Senão, pode chamar Is user deleted para testar a conta de usuário antes de chamarGET USER PROPERTIES.

Depois da chamada, recupera o nome, método de inicio, senha criptografada, número de logins e a data da última utilização do banco nos parâmetros nome, inicio, senha, numLogin e ultLogin.

Notas:

  • os parâmetros numLogin e ultLogin são usados apenas em bancos de dados binários. Sempre retornam, respectivamente, 0 e 00/00/00 em bancos de dados projeto
  • o parâmetro senha é obsoleto (sempre devolve uma string vazia). Se deseja verificar a senha de um usuário, utilize a função Validate password.

Se passa o parâmetro opcional adesao, recupera os números de referência únicos dos grupos aos quais pertence o usuário.

(Apenas Bancos de dados Binários) Se passar o parâmetro opcional proprietGrupo, obtém o número de referência do grupo “proprietário” do usuário, ou seja o grupo proprietário por padrão dos objetos criados por este usuário.

Note: O array proprietGrupo sempre retorna 0 em bancos de dados projeto.

Nota para bancos de dados binários. Valors das IDs de referência de grupo e de usuários dependem de seus criadores (Designer, Administrador, ou proprietário de grupo afiliado) Para saber mais veja o parágrafo User and group ID ranges.

Gestão de erros

Se não tiver privilégios de acesso para chamar ao comando GET USER PROPERTIES ou se outro processo abriu no sistema de senhas, um erro de privilégios de acesso é gerado. Pode interceptar este erro com un método de gestão de erros instalado por ON ERR CALL.

Ver também

GET GROUP LIST
GET USER LIST
Is user deleted
Set user properties
Validate password