Método IUserIdentityManager::Logon

[IUserIdentityManager::Logon não tem suporte e pode ser alterado ou indisponível no futuro. Em vez disso, use contas de usuário com Troca Rápida de Usuário e Área de Trabalho Remota.]

Exibe uma interface do usuário para o usuário, permitindo que o usuário escolha uma identidade de usuário. Se tiver êxito, a identidade do usuário será conectada e recuperada.

Sintaxe

HRESULT Logon(
  [in]  HWND          hwndParent,
  [in]  DWORD         dwFlags,
  [out] IUserIdentity **ppIdentity
);

Parâmetros

hwndParent [in]

Digite: HWND

Um valor HWND que identifica uma janela que será trazida para o primeiro plano depois que a interface do usuário de logon for descartada.

dwFlags [in]

Tipo: DWORD

Sinalizadores opcionais para definir como a interface do usuário se comportará. Defina como UIL_FORCE_UI para forçar a interface do usuário a ser exibida, mesmo que uma identidade já tenha sido escolhida.

ppIdentity [out]

Tipo: IUserIdentity**

O endereço do ponteiro que recebe a identidade de usuário escolhida.

Retornar valor

Tipo: HRESULT

Resultado da operação de logon. Se tiver êxito, ele retornará S_OK. Caso contrário, ele retornará um dos seguintes códigos de erro.

Código de retorno Descrição
E_USER_CANCELLED
O usuário cancelou a operação de logon da interface do usuário.
E_OUTOFMEMORY
Não foi possível criar a identidade do usuário.
E_UNEXPECTED
A operação falhou inesperadamente.
E_IDENTITIES_DISABLED
O gerenciamento de identidades está desabilitado no sistema.
S_IDENTITIES_DISABLED
O gerenciamento de identidades está desabilitado no sistema.
E_IDENTITY_CHANGING
No momento, o sistema está alternando identidades e não pode concluir a operação.

 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Fim do suporte ao cliente
Windows 2000 Professional
Fim do suporte ao servidor
Windows 2000 Server
Cabeçalho
Msident.h
IDL
Msident.idl
DLL
Msident.dll

Confira também

IUserIdentityManager

IUserIdentityManager::Logoff

IUserIdentityManager::ManageIdentities