UserVerify

Verifies a given user by authenticating the user's credential, verifies the user privileges and areas against those specified in the functions parameters. Successful verification however does not log the user into the Plant SCADA runtime system.

This function is a blocking function. It blocks the calling Cicode task until the operation is complete.

Syntax

UserVerify(sName, sPassword [, sAccess] [, sPrivGlobal] [, sPriv1..sPriv8] )

sName:

The name of the user.

sPassword:

The password of the user. The sPassword argument needs to be passed as a secure string.

sAccess:

Specifies the required user's viewable areas.

sPrivGlobal:

Specifies the required user's global privilege.

sPriv1-8:

Specifies the required areas for privileges 1 - 8. That is, sPriv1 contains the areas (1,2,3,4,...,255) where the user has Privilege 1.

Return Value

0 (zero) if successful, otherwise an error code is returned.

The successful verification has to meet the following conditions:

• The selected user credentials can be authenticated

• The required user privileges are included in the authenticated user's total privileges.

Related Functions

UserDelete, UserEditForm, UserPassword, UserPasswordForm, UserCreateForm

Example

INT FUNCTION UserVerifyTest()

STRING sName;

STRING sPassword;

INT bDone;

INT nStatus;

bDone = FALSE;

WHILE bDone = FALSE DO

FormNew("@(Login Form)", 30, 5, 5);

FormInput(1, 0, "@(Name)" + " ", sName, 16);

FormSecurePassword(1, 2, "@(Password)" + " ", sPassword, 16);

FormButton( 1, 4, " " + "@(OK)" + " ", 0, 1);

FormButton(17, 4, "@(Cancel)", 0, 2);

IF FormRead(0) = 0 THEN

IF UserVerify(sName, sPassword) = 0 THEN

bDone = TRUE;

nStatus = 0;

Message("Info", "Verification successful", 0)

ELSE

sPassword = "";

Message("Info", "Verification not successful", 0)

END

ELSE

bDone = TRUE;

nStatus = 298;

END

END

RETURN nStatus;

END

See Also

Security Functions