See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This optional function is called when the device needs to block an user from continuing for a set period of time. This is a LAP-exported function.
Syntax
BOOL LAPLockoutUser( HWND hwnd, LPCWSTR pwszAEDisplayText, DWORD cSecondsToLockout ); |
Parameters
- hwnd
-
[in] Handle to the parent window. This value may be NULL.
- pwszAEDisplayText
-
[in] Pointer to the text for the LAP to display. The value will be the same pwszAEDisplayTextas passed to VerifyUser (LAP).
- cSecondsToLockout
-
[in] Amount of time, in seconds, to block the user from continuing.
Return Value
Returns TRUE if the user was successfully locked out for the duration specified in cSecondsToLockout.
Returns FALSE if the user cancels during the lockout period. If the return value is FALSE, the LASS knows that lockout was not completed successfully and the lockout will be run again the next time the user tries authenticate. To provide more details about why the function failed, use SetLastError.
Remarks
This function is used with exponential backoff. The simplest implementation of this API is to disable use of device features (except for emergency calling) for cSecondsToLockoutseconds. For a more robust implementation, the UI could display a dialog informing the user they have cSecondsToLockoutseconds before they can continue.
 Note: |
|---|
| It is very important for users to be able to dial emergency numbers while locked out of the device. Any implementation of this function needs to provision for such a scenario. |
|
Note: |
|---|
| This function is called by the LASS, not the application. Therefore, no link library is exposed. . |
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. |