Estrutura PROFILEINFOW (profinfo.h)

Contém informações usadas ao carregar ou descarregar um perfil de usuário.

Sintaxe

typedef struct _PROFILEINFOW {
  DWORD              dwSize;
  DWORD              dwFlags;
  MIDL_STRING LPWSTR lpUserName;
  MIDL_STRING LPWSTR lpProfilePath;
  MIDL_STRING LPWSTR lpDefaultPath;
  MIDL_STRING LPWSTR lpServerName;
  MIDL_STRING LPWSTR lpPolicyPath;
#if ...
  ULONG_PTR          hProfile;
#else
  HANDLE             hProfile;
#endif
} PROFILEINFOW, *LPPROFILEINFOW;

Membros

dwSize

Tipo: DWORD

O tamanho dessa estrutura, em bytes.

dwFlags

Tipo: DWORD

Esse membro pode ser um dos seguintes sinalizadores:

PI_NOUI

Impede a exibição de mensagens de erro de perfil.

PI_APPLYPOLICY

Não há suporte.

lpUserName

Tipo: LPTSTR

Um ponteiro para o nome do usuário. Esse membro é usado como o nome base do diretório no qual armazenar um novo perfil.

lpProfilePath

Tipo: LPTSTR

Um ponteiro para o caminho de perfil do usuário móvel . Se o usuário não tiver um perfil móvel, esse membro poderá ser NULL. Para recuperar o caminho de perfil móvel do usuário, chame a função NetUserGetInfo , especificando o nível de informações 3 ou 4. Para obter mais informações, consulte Comentários.

lpDefaultPath

Tipo: LPTSTR

Um ponteiro para o caminho de perfil de usuário padrão. Esse membro pode ser NULL.

lpServerName

Tipo: LPTSTR

Um ponteiro para o nome do controlador de domínio de validação, no formato NetBIOS.

lpPolicyPath

Tipo: LPTSTR

Não usado, defina como NULL.

hProfile

Tipo: HANDLE

Um identificador para a subárvore do registro HKEY_CURRENT_USER . Para obter mais informações, consulte Comentários.

Comentários

Não use variáveis de ambiente ao especificar um caminho. A função LoadUserProfile não expande variáveis de ambiente, como %username%, em um caminho.

Quando a chamada LoadUserProfile retorna com êxito, o membro hProfile recebe um identificador de chave do Registro aberto na raiz da subárvore do usuário, aberto com acesso completo (KEY_ALL_ACCESS). Para obter mais informações, consulte as seções Comentários em LoadUserProfile, Segurança de Chave do Registro e Direitos de Acesso e Hives do Registro.

Serviços e aplicativos que chamam LoadUserProfile devem marcar para ver se o usuário tem um perfil móvel. Se o usuário tiver um perfil móvel, especifique seu caminho como o membro lpProfilePath dessa estrutura.

Observação

O cabeçalho profinfo.h define PROFILEINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de funçã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]
Cabeçalho	profinfo.h (inclua Userenv.h)

Confira também

LoadUserProfile

UnloadUserProfile

Visão geral de perfis de usuário