Share via


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

Parameters

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

Return Value

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

Remarks

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.

Requirements

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

See Also

Reference

File System Password Functions
GetPasswordActive
SetPassword
SetPasswordActive