Compartir a través de


Función RefreshPolicyEx (userenv.h)

La función RefreshPolicyEx hace que la directiva se aplique inmediatamente en el equipo. La función extendida permite especificar el tipo de actualización de directiva que se va a aplicar.

Sintaxis

USERENVAPI BOOL RefreshPolicyEx(
  [in] BOOL  bMachine,
  [in] DWORD dwOptions
);

Parámetros

[in] bMachine

Especifica si se va a actualizar la directiva de equipo o la directiva de usuario. Si este valor es TRUE, el sistema actualiza la directiva de equipo. Si este valor es FALSE, el sistema actualiza la directiva de usuario.

[in] dwOptions

Especifica el tipo de actualización de directiva que se va a aplicar. Este parámetro puede ser el siguiente valor.

RP_FORCE

Vuelva a aplicar todas las directivas incluso si no se detectó ningún cambio de directiva.

Tenga en cuenta que si hay extensiones del lado cliente que se pueden aplicar durante el arranque o el inicio de sesión ( por ejemplo, una extensión de instalación de la aplicación), las extensiones se vuelven a aplicar en el siguiente arranque o inicio de sesión, incluso si no se detecta ningún cambio de directiva.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si no necesita especificar el parámetro dwOptions , puede llamar a la función RefreshPolicy en su lugar.

De forma predeterminada, la directiva se vuelve a aplicar cada 90 minutos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado userenv.h
Library Userenv.lib
Archivo DLL Userenv.dll

Consulte también

Funciones de directiva de grupo

Introducción a las directivas de grupo

ProcessGroupPolicy

ProcessGroupPolicyEx

RefreshPolicy