Share via


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);

Parameters

None.

Return Value

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.

Remarks

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

Requirements

Header pwinbase.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

File System Password Functions
CheckPassword
GetPasswordActive
SetPassword
SetPasswordStatus