Share via


LAPDisplayCodeword

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This optional function displays a dialog prompting for pwszCodeword to be entered. This is a LAP-exported function.

Syntax

BOOL LAPDisplayCodeword(
  HWND hwndParent,
  LPCWSTR pwszCodeword
);

Parameters

  • hwndParent
    [in] Handle to the parent window. This value can also be NULL.
  • pwszCodeword
    [in] Pointer to the codeword to be entered for verification. This value can also be NULL or an empty string, if the LAP verifies the user in another way.

Return Value

Returns TRUE if the dialog is displayed successfully. The function returns FALSE if the verification is aborted. To provide more details about why the function failed, use SetLastError.

Remarks

To ensure that a 'live' user is authenticating with the device, the user can periodically be prompted to enter a codeword for verification. The parameter pwszCodeword is provided for convenience, but it is not required for verification. For example, the function might implement verification using a biometric device, such as a fingerprint scanner.

If this function is implemented using any kind of UI other than a simple click and dismiss dialog box, the user must be able to place emergency calls while the function is running.

Note

This function is not designed as a security feature to prevent hacking or password guessing.

Note

This function is called by the LASS, not the application. Therefore, no link library is exposed. For more information, see Creating a LAP..

Requirements

Header lap.h
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later, Windows Mobile 6 Standard and later
Note This function is called by the LASS, not the application. Therefore, no link library is exposed. For more information see Creating a LAP.

See Also

Reference

LAP-Exported Functions