VerifyUserStart (Windows Embedded CE 6.0)
1/6/2010
This function indicates that one or more VerifyUser calls are about to occur. An application call to VerifyUser will result in multiple VerifyUser (LAP) calls, if the VU_UNTIL_SUCCESS flag is set. Before the LASS makes the first VerifyUser (LAP) call, it calls VerifyUserStart. The LAP can use this function to draw its UI. This is a LAP-exported function.
Syntax
VOID VerifyUserStart(
const GUID* AEKey,
LPCWSTR pwszAEDisplayText,
HWND hWndParent,
DWORD dwOptions,
PVOID pExtended
);
Parameters
- AEKey
[in] Authentication event identifier. The identifier corresponds to the type of authentication required.
- pwszAEDisplayText
[in] Pointer to the text for the LAP to display. This will be the same pwszAEDisplayText that is passed to LAPLockoutUser and VerifyUser (LAP)
- hWndParent
[in] Handle to the parent window.
dwOptions
[in] A bitmask of options. The following table shows the possible values.Value Description VU_NO_UI
Return from VerifyUserStart without displaying the UI.
VU_HANDLE_MASTER_KEY
Handle master key encryption and decryption if master key encryption and decryption are supported.
VU_UNTIL_SUCCESS
Keep calling into the LAP until the user cancels, or until the user successfully verifies.
- pExtended
Reserved. Must be zero.
Return Value
None.
Remarks
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 Embedded CE | Windows CE 5.0 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. |