Função GetProfileType (userenv.h)

  • Artigo

Recupera o tipo de perfil carregado para o usuário atual.

Sintaxe

USERENVAPI BOOL GetProfileType(
  [out] DWORD *dwFlags
);

Parâmetros

[out] dwFlags

Tipo: DWORD*

Ponteiro para uma variável que recebe o tipo de perfil. Se a função for bem-sucedida, ela definirá um ou mais dos seguintes valores:

PT_MANDATORY

O usuário tem perfis de usuário obrigatórios.

PT_ROAMING

O usuário tem perfis de usuário móvel.

PT_ROAMING_PREEXISTING

O usuário tem um Perfil de Usuário Móvel que foi criado em outro computador e está sendo baixado. Esse tipo de perfil implica PT_ROAMING.

PT_TEMPORARY

O usuário tem perfis de usuário temporários; ele será excluído no logoff.

Retornar valor

Tipo: BOOL

TRUE se tiver êxito; caso contrário, FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se o perfil do usuário ainda não estiver carregado, a função falhará.

Observe que o chamador deve ter acesso KEY_READ a HKEY_LOCAL_MACHINE. Esse direito de acesso é concedido por padrão. Para obter mais informações, consulte Segurança de chave do Registro e Direitos de Acesso.

Se o tipo de perfil for PT_ROAMING_PREEXISTING, Explorer não reinicializará as associações de programas padrão quando um perfil for carregado em um computador pela primeira vez.

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]
Plataforma de Destino Windows
Cabeçalho userenv.h
Biblioteca Userenv.lib
DLL Userenv.dll

Confira também

LoadUserProfile

Visão geral de perfis de usuário

Referência de perfis de usuário