GET USER PROPERTIES

4D v20 R7

GET USER PROPERTIES


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

Parâmetro	Tipo	Descrição
refUsuario	Inteiro longo	Nº de referência de usuário
nome	String	Nome de usuário
inicio	String	Nome de método de início
senha	String	Sempre é uma cadeia vazia
numLogin	Inteiro longo	Número de logins para o banco de dados
ultLogin	Data	Data do último login ao banco de dados
adesao	Array inteiro longo	Número de ID dos grupos ao qual o usuário pertence
propGrupo	Inteiro longo	Número de ID do proprietário do grupo

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