LAPDisplayCodeword
A version of this page is also available for
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. |