Compartilhar via


VerifyUser (LAP)

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Esta função executa verificação a usuário. Ele basicamente tem os mesmos parâmetros como o aplicativo-chamado VerifyUser função. Essa é uma função LAP-Exported.

Syntax

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

Parameters

  • AEKey
    [no] Ponteiro para o identificador evento autenticação. O identificador corresponde ao tipo de autenticação exigido.
  • pwszAEDisplayText
    [no] Ponteiro para o texto para o LAP para exibir. Isso será a mesma psszAEDisplayText Como passado para LAPLockoutUser.
  • hWndParent
    [no] Identificador para o janela pai.
  • dwOptions
    [no] Um máscara de bits de opções. A seguinte tabela mostra os valores possíveis.

    Valor Descrição

    VU_NO_UI

    Quando esse sinalizador é definido, o LAP não pode exibir interface do usuário ou bloco em chamadas para VerifyUser. Ao usar esse valor, a função retornará TRUE Somente se o usuário pode ser verificado sem exibir o interface do usuário. Caso contrário, ela retornará FALSE.

    VU_HANDLE_MASTER_KEY

    Quando este sinalizador estiver definido, ele indica ao mestre identificador chave criptografia e descriptografia se mestre chave criptografia e descriptografia são com suporte.

    VU_UNTIL_SUCCESS

    Quando esse sinalizador for definido, o LAP VerifyUser entrada-função apontar será chamado até que o usuário cancela ou até que a chamar for bem-sucedido.

    Observe que pode haver múltiplo chama para VerifyUser Durante o tempo entre a chamar para VerifyUserStart e a chamar para VerifyUserStop. Isso permite que você armazenar em cache estado durante o tempo entre a chamar para VerifyUserStart e a chamar para VerifyUserStop.

  • pExtended
    Reservado. Deve ser definido como NULL.

Return Value

Retorna TRUE Se o usuário é verificado, e FALSE caso contrário. Para fornecer mais detalhes sobre por que usar a função falha, SetLastError.

Remarks

Quando um aplicativo chama um VerifyUser Com o conjunto sinalizador VU_UNTIL_SUCCESS, o chamar pode resultar em várias chamadas para o LAP. Para evitar interface do usuário memória flash, o irá LASS chamar VerifyUserStart Antes de qualquer VerifyUser Chamadas (LAP) são feitas. Afinal de contas VerifyUser Chamadas foram feitas, o LASS será chamar VerifyUserStop.

Quando o aplicativo chama VerifyUser, o LAP exibe seu diálogo verificação. É possível para um segundo aplicativo para executar e exibir seu interface do usuário em parte superior de verificação de LAP interface do usuário na ordem z. Se o aplicativo segundo, em seguida, chama VerifyUser, ele será bloco. Para evitar esse bloqueio interface do usuário, o LASS será chamar VerifyUserToTop a solicitação de LAP para trazer o interface do usuário para o parte superior da ordem z.

Observação

Essa função é chamado pelo LASS, não o aplicativo.Portanto, nenhuma biblioteca link é exposta. Para obter mais informações, consulte Criando um LAP..

Observação

O PromptForPasswd função é substituído.Use o VerifyUser função em vez disso.

Requirements

Header lap.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 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.

See Also

Reference

LAP-Exported Functions
VerifyUser
VerifyUserStart
VerifyUserStop
VerifyUserToTop