VerifyUser

9/8/2008

Essa função autentica o usuário. Um aplicativo chama essa função.

Syntax

BOOL VerifyUser(
  const GUID* AEKey,
  LPCWSTR wszAEDisplayText,
  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.

• wszAEDisplayText
  [no] Ponteiro para o texto para o LAP para exibir. Se esse valor é NULL, a função usa o valor definido no Registro.

• 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	Retorna a partir VerifyUser sem exibir o interface do usuário. 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	Manipular mestre chave criptografia e descriptografia se mestre chave criptografia e descriptografia são com suporte. Observação A opção VU_HANDLE_MASTER_KEY é válido somente quando ela está definida por um aplicativo privilegiado.
  VU_UNTIL_SUCCESS	Manter chamado para o LAP até que o usuário cancela, ou até que o usuário verifica com êxito. > [!NOTE] > Se o sinalizador VU_NO_UI é passado para a função, VU_UNTIL_SUCCESS será ignorado.

  • pExtended
    Reservado. Deve ser definido como NULL.

  Return Value

  Retorna TRUE Se o usuário é verificado, e FALSE caso contrário. Para informações de erro estendidas get, o aplicativo deve chamar GetLastError. Se o usuário cancelou a solicitação verificação, GetLastError Retorna ERROR_CANCELLED. Se a falha usuário autenticação, GetLastError Retorna o ERROR_WRONG_PASSWORD ou uma mais aplicável codificar definido pelo LAP.

  Remarks

  VerifyUser pode ser chamado por qualquer aplicativo, se ele é privilegiado ou normal.

  Observação

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

  Example

  O seguinte exemplo mostra como o aplicativo pode usar VerifyUser Para autenticar o usuário antes chamado qualquer Seguro função. CallSecureFunction e TellUserVerificationFailed Este exemplo são funções User-defined.

  APP A;
  HWND hMyWindow;
  VerifyAndCallSecureFunction() 
  {
      DWORD LastError;
      GUID AEKeyForFoo = ...;
      if (VerifyUser(&AEKeyForFoo,"App A",hMyWindow,VU_UNTIL_SUCCESS,0))  //  Call into LASS; This will  
         CallSecureFunction()  // call into active LAP and show LAP-specific UI
      else 
         TellUserVerificationFailed(GetLastError()));  // display your own UI
  }
  

  Requirements

  Header	lap.h
  Library	coredll.lib
  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

  See Also

  Reference

  LASS Functions
  Setting an AE Policy
  Installing an AE
  VerifyUser (LAP)

  Concepts

  Comparing LASS and Password Authentication