Share via

CheckPassword (Compact 2013)

  • Article

3/26/2014

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

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.

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

See Also

Reference

File System Password Functions
GetPasswordActive
SetPassword
SetPasswordActive