Share via

VerifyUser (LAP)

  • Article

This function performs the user verification. It has basically the same parameters as the application-called VerifyUser function. This is a LAP-exported function.

BOOL VerifyUser(
  const GUID* AEKey,
  LPCWSTR pwszAEDisplayText,
  HWND hWndParent,
  DWORD dwOptions,
  PVOID pExtended
);

Parameters

  • AEKey
    [in] Pointer to the 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 VerifyUser (LAP) without displaying the UI. Return true only if a call to the LAP is not necessary.
    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 set to NULL.

Return Values

Returns TRUE if the user is verified, and FALSE otherwise. To get extended error information, the LASS will call GetLastError. If the user cancelled the verification request, GetLastError returns ERROR_CANCELLED. If the user failed authentication, GetLastError returns ERROR_NOT_AUTHENTICATED.

Remarks

When an application calls VerifyUser with the VU_UNTIL_SUCCESS flag set, the call can result in several calls into the LAP. To prevent UI flash, the LASS will call VerifyUserStart before any VerifyUser (LAP) calls are made. After all VerifyUser calls have been made, the LASS will call VerifyUserStop.

When the application calls VerifyUser, the LAP displays its verification dialog. It is possible for a second application to run and display its UI on top of the LAP verification UI in the z order. If the second application then calls VerifyUser, it will block. To prevent this UI blockage, the LASS will call VerifyUserToTop to request the LAP to bring its UI to the top of the z order.

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 | VerifyUserStart | VerifyUserStop | VerifyUserToTop