Estrutura PROFILEINFOW (profinfo.h)
Contém informações usadas ao carregar ou descarregar um perfil de usuário.
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;
dwSize
Tipo: DWORD
O tamanho dessa estrutura, em bytes.
dwFlags
Tipo: DWORD
Esse membro pode ser um dos seguintes sinalizadores:
Impede a exibição de mensagens de erro de perfil.
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.
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.
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) |
unloadUserProfile