GetPasswordStatus (Windows Embedded CE 6.0)

1/6/2010

This function retrieves the current status of the system password.

Note The default Local Authentication Plugin (LAP) blocks the usage of the SetPasswordActive and the CheckPassword functions. Applications should not use these functions for authenticating the user. Use the VerifyUser and the CreateEnrollmentConfigDialog functions instead. For more information, see Local Authentication Plugin (LAP).

Syntax

DWORD GetPasswordStatus(void);

None.

The following table shows possible values.

Value	Description
PASSWORD_STATUS_ACTIVE	Makes the system password active. If this bit is not set, the password is disabled.
PASSWORD_STATUS_SCREENSAVERPROTECT	Makes the password active for a screen saver. When this is set, it causes the startup screen to be displayed when a screen saver is deactivated by the user. If this bit is not set, no startup screen is displayed when the screen saver is deactivated by a user. The PASSWORD_STATUS_ACTIVE flag must also be set to set this flag.

To use this function, you must first set WINCEOEM to 1. For more information, see WINCEOEM.