CheckPassword (Windows Embedded CE 6.0)

1/6/2010

This function validates a password by checking a string to determine if it matches the current password.

A Remote API version of this function exists called CeCheckPassword (RAPI).

Note The default Local Authentication Plugin (LAP) blocks the usage of the SetPasswordActive function and this function. 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 CheckPassword(
  LPWSTR lpszPassword 
);

lpszPassword
Pointer to a null-terminated string containing the password to verify.

TRUE indicates a valid password. Otherwise, the password is invalid.

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

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

This function can be called only by privileged applications. Otherwise, the call fails and GetLastError returns ERROR_ACCESS_DENIED.

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