Share via

VerifyUserStart (Compact 2013)

  • Article

3/28/2014

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.

Requirements

Header

lap.h

See Also

Reference

LAP-Exported Functions
VerifyUser (LAP)
VerifyUser