UserMgrLogin (FUN)

FUNCTION UserMgrLogin : RTS_IEC_HANDLE

Logs user in to the runtime system requiring an active user management.

InOut:

Scope

Name

Type

Comment

Return

UserMgrLogin

RTS_IEC_HANDLE

Handle to the user or RTS_INVALID_HANDLE if not available

Input

pszUser

REFERENCE TO STRING

Name of the user, limited to 59 chars

pszPassword

REFERENCE TO STRING

Password (plain text), limited to 59 chars

pResult

POINTER TO RTS_IEC_RESULT

Pointer to error code
  • ERR_OK: User/password combination is valid

  • ERR_ACTIVATE_USERMGMT: The login was successful. But the user management is enforced and not active. Activate the user management.

  • ERR_CHANGE_PASSWORD: The login was successful. But the user must change his password.

  • ERR_NO_USERMGMT: Login was not successful. The user management is not activated. Use empty user and password to login.

  • ERR_NO_ACCESS_RIGHTS: The login was not successful, because of another reason.