SET_SECURITY_PSW
Limpa a configuração de segurança de todos os grupos da aplicação (deixa todos habilitados com atributo zero, sem restrição) e define a senha usada para liberar recursos posteriormente protegidos por senha (atributo 1); falha se o equipamento não suportar recursos de segurança. É uma função.
Biblioteca: HI_STD · Namespace: HILS · Tipo: função
Função
SET_SECURITY_PSW
+-------------+
UINT ---|PASSW |--- INT
+-------------+
A função executa duas tarefas: (1) limpa a configuração de todos os grupos de segurança da aplicação, mantendo-os habilitados com atributo zero (sem restrição); e (2) define a senha para liberação dos recursos que posteriormente forem bloqueados com atributo de liberação por senha (atributo 1).
Importante
Para consultar os grupos e os atributos de segurança disponíveis acesse: Recursos de segurança da aplicação
Nota
Se esta função não for chamada pela aplicação para definir uma senha, o equipamento inicializa este valor como zero. Portanto, a senha default associada aos recursos de segurança é zero.
Se o equipamento não suportar os Recursos de segurança da aplicação, a função falha e
retorna HILS.RE_NOT_AVA.
Ver também
Estão disponíveis na Biblioteca HI_STD dois tipos de dados enumeradores que permitem a definição de flags associados aos grupos e atributos de segurança, para mais informações acesse:
Parâmetros
Nome |
Direção |
Tipo |
Padrão |
Faixa / Unidade |
Descrição |
|---|---|---|---|---|---|
PASSW |
IN |
UINT |
0 |
— |
Senha do projeto para liberação dos flags de segurança configurados. |
Códigos de retorno
A função retorna um INT com o código de retorno da operação. Use os
identificadores com o namespace HILS (ex.: HILS.RE_NOT_AVA). Códigos mais
comuns:
Código |
Identificador |
Significado |
|---|---|---|
0 |
SUCCESS |
Configuração limpa e senha definida com sucesso. |
1 |
FAIL |
Erro genérico no processamento. |
24 |
RE_NOT_AVA |
Equipamento não suporta os recursos de segurança. |
Lista completa dos códigos de retorno: RET_CODE - Códigos de retorno do firmware G5.
Pré-condições
O equipamento deve suportar os Recursos de segurança da aplicação; caso contrário a função retorna
HILS.RE_NOT_AVA.
Observações
Se a função não for chamada, a senha default associada aos recursos de segurança é zero.
A chamada zera o atributo de todos os grupos (sem restrição), mantendo-os habilitados.
Exemplo
Clique aqui para baixar a tabela de variáveis
Código ST
VAR
RET : INT; (* Codigo de retorno *)
END_VAR
(* Exemplo de ativacao da funcao dentro da POU *)
(* ... *)
RET := HILS.SET_SECURITY_PSW(PASSW := 1234); (* Define a senha de seguranca *)
(* ... *)