LAPDisplayCodeword (Compact 2013)
3/28/2014
Implement this optional function to display a dialog prompting for the code word for a user to enter on a Windows Embedded Compact powered device. A custom Local Authentication Plugin (LAP) can export this 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 verify. This value is optional. If the LAP uses non-text forms of authentication such as fingerprints or iris scan, set this value to NULL or an empty string.
Return Value
Implement this method to return TRUE if the dialog is displayed successfully. Otherwise, return FALSE if the verification is aborted. To provide more details about why the function failed, implement SetLastError in your implementation.
Remarks
To ensure that an authorized person is actively using a device, the user can periodically be prompted to enter credentials for verification. The parameter pwszCodeword is provided only for text-based authentication, but it is not required for verification. For example, a custom LAP might implement verification using a biometric device, such as a fingerprint scanner, instead of using password text.
Note
This user-implemented function is called by the LASS, not by an application. Therefore, no link library is exposed.
Requirements
Header |
lap.h |