Share via


VerifyUserStart

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.

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. If this value is NULL, the function uses the value set in the registry.
  • 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 Values

None.

Requirements

Pocket PC: Windows Mobile 5.0 and later.
Smartphone: Windows Mobile 5.0 and later.
OS Versions: Windows CE 5.0 and later.
Header: Lap.h.
Link Library: Coredll.lib.

See Also

LAP-Exported Functions | VerifyUser (LAP) | VerifyUser