Password
 

 < Home   < Developers   < Development Support   < Documentation

42 Password


 Table of Contents  |  < Previous  |  Next >  |  Index
   
   

Title -
Palm OS® Programmer's API Reference

Part II: System Management

42 Password

Password Functions

PwdExists

PwdRemove

PwdSet

PwdVerify

       

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

oldPasswordThe old password must be successfully verified or the new password isn't accepted
newPasswordChar* 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

stringString to compare to the system password. NULL means no current password.
The allocated length of string must be at least pwdLength characters long.

Result

Returns true if the string matches the system password.