Função RefreshPolicyEx (userenv.h)

Artigo
03/09/2024

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