SetCurrentUser
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função define o atual usuário que fez logon.
Syntax
BOOL SetCurrentUser(
LPCWSTR lpszUserName,
LPBYTE lpbUserSecret,
DWORD dwDataSize,
BOOL bCreateIfNew
);
Parameters
- lpszUserName
[no] NULL-finalizada seqüência de caracteres contendo nome logon de usuário. O nome deve ser um válido arquivo nome porque um Diretório é criado para o perfil usuário. Nomes de usuário são sem diferenciação de maiúsculas e minúsculas.
- lpbUserSecret
[no] Buffer de dados criptografados User-specific, such as uma senha.
- dwDataSize
[no] Tamanho do secreto usuário dados.
- bCreateIfNew
[no] Especifica que um novo usuário for criado se o nome especificado no lpszUserName Já existe no sistema.
Return Value
Retorna TRUE se o novo usuário efetuou logon. Se o usuário especificado já foi feito logon, retorna FALSE e deixa que usuário feito logon. Este maiúsculas e minúsculas, GetLastError retorna ERROR_USER_EXISTS. Se a chamar falhar por qualquer outro motivo, essa função retorna FALSE e registra o atual usuário desativado.
Remarks
Essa função é acessível somente a aplicativos com privilégios.
Quando o usuário tiver feito logon, essa função ajusta o Registro como aplicável e fornece a dados criptografados usuário para o subsistema de segurança para desbloquear o usuário credenciais. Essa função faz logoff qualquer usuário anterior.
Se o novo usuário for o mesmo que o usuário anterior, a chamar falhar, e GetLastError Retorna ERROR_USER_EXISTS, deixando o mesmo usuário feito logon. Ele torna não chamar para o subsistema de segurança. Em qualquer outra maiúsculas e minúsculas quando esta função falhar, a atual usuário é desconectado, e nenhum novo usuário fizer logon.
Não se houver nenhum usuário, definida lpszUserName e lpbUserSecret Para NULL, dwDataSize para zero, e bCreateIfNew para FALSE.
Requirements
| Header | pwinreg.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
User Management Functions
SetUserData
GetUserNameEx
RegReplaceKey
RegSaveKey