Share via


GetPasswordStatus (Compact 2013)

3/26/2014

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.

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.

Requirements

Header

pwinbase.h

Library

coredll.lib

See Also

Reference

File System Password Functions
CheckPassword
GetPasswordActive
SetPassword
SetPasswordStatus