GetPasswordActive (Windows Embedded CE 6.0)

1/6/2010

This function retrieves the current state of the 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

BOOL GetPasswordActive(void); 

Parameters

None.

Return Value

TRUE indicates that an active password exists in the system. Otherwise, FALSE is returned.

Remarks

If TRUE is returned, use the CheckPassword function to verify the password before allowing further use of the system.

To use this function, you must include the password component, Fspass, in the Cesysgen.bat file.

For a sample usage of this function, see the files in %_WINCEROOT%\Public\Common\Oak\Drivers\Startui.

Requirements

Header windbase.h
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

File System Password Functions
CheckPassword
SetPassword
SetPasswordActive