Estrutura PROFILEINFOA (profinfo.h)
Contém informações usadas ao carregar ou descarregar um perfil de usuário.
Sintaxe
typedef struct _PROFILEINFOA {
DWORD dwSize;
DWORD dwFlags;
MIDL_STRING LPSTR lpUserName;
MIDL_STRING LPSTR lpProfilePath;
MIDL_STRING LPSTR lpDefaultPath;
MIDL_STRING LPSTR lpServerName;
MIDL_STRING LPSTR lpPolicyPath;
#if ...
ULONG_PTR hProfile;
#else
HANDLE hProfile;
#endif
} PROFILEINFOA, *LPPROFILEINFOA;
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) |