38 Password

This chapter provides reference material for the password API. The password API is declared in the header file Password.h.

Password Functions

PwdExists

Purpose

Return true if the system password is set.

Prototype

Boolean PwdExists()

Parameters

None

Result

Returns true if the system password is set.

PwdRemove

Purpose

Remove the encrypted password string and recover data hidden in databases.

Prototype

void PwdRemove(void)

Parameters

None

Result

Returns nothing.

PwdSet

Purpose

Use a passed string as the new password. The password is stored in an encrypted form.

Prototype

void PwdSet (Char* oldPassword, Char* newPassword)

Parameters

oldPassword

The old password must be successfully verified or the new password isn't accepted

newPassword

Char* to a string to use as the password. NULL means no password.

Result

Returns nothing.

PwdVerify

Purpose

Verify that the string passed matches the system password.

Prototype

Boolean PwdVerify (Char* string)

Parameters

string

String to compare to the system password. NULL means no current password.

Result

Returns true if the string matches the system password.