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 perfil de usuário móvel caminho. 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 do 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, definido como NULL.

hProfile

Tipo: HANDLE

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

Observações

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 do 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, de Direitos de Acesso e Segurança de Chave do Registro e Hives do Registro.

Serviços e aplicativos que chamam LoadUserProfile devem verificar se o usuário tem um perfil móvel. Se o usuário tiver um perfil móvel, especifique seu caminho como o lpProfilePath membro 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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho profinfo.h (inclua Userenv.h)

Consulte também

LoadUserProfile

unloadUserProfile

Visão geral dos perfis de usuário