Função RefreshPolicyEx (userenv.h)
A função RefreshPolicyEx faz com que a política seja aplicada imediatamente no computador. A função estendida permite que você especifique o tipo de atualização de política a ser aplicada.
Sintaxe
USERENVAPI BOOL RefreshPolicyEx(
[in] BOOL bMachine,
[in] DWORD dwOptions
);
Parâmetros
[in] bMachine
Especifica se a política de computador ou a política de usuário deve ser atualizada. Se esse valor for TRUE, o sistema atualizará a política do computador. Se esse valor for FALSE, o sistema atualizará a política de usuário.
[in] dwOptions
Especifica o tipo de atualização de política a ser aplicada. Esse parâmetro pode ser o valor a seguir.
RP_FORCE
Reaplicar todas as políticas mesmo que nenhuma alteração de política tenha sido detectada.
Observe que, se houver extensões do lado do cliente que possam ser aplicadas no momento da inicialização ou logon(por exemplo, uma extensão de instalação do aplicativo), as extensões serão aplicadas novamente na próxima inicialização ou logon, mesmo se nenhuma alteração de política for detectada.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Se você não precisar especificar o parâmetro dwOptions , poderá chamar a função RefreshPolicy .
Por padrão, a política é reaplicada a cada 90 minutos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | userenv.h |
| Biblioteca | Userenv.lib |
| DLL | Userenv.dll |