RefreshPolicyEx-Funktion (userenv.h)

Artikel
08/26/2023

Die RefreshPolicyEx-Funktion bewirkt, dass die Richtlinie sofort auf dem Computer angewendet wird. Mit der erweiterten Funktion können Sie den Typ der anzuwendenden Richtlinienaktualisierung angeben.

Syntax

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

Parameter

[in] bMachine

Gibt an, ob die Computer- oder Benutzerrichtlinie aktualisiert werden soll. Wenn dieser Wert TRUE ist, aktualisiert das System die Computerrichtlinie. Wenn dieser Wert FALSE ist, aktualisiert das System die Benutzerrichtlinie.

[in] dwOptions

Gibt den Typ der anzuwendenden Richtlinienaktualisierung an. Dieser Parameter kann der folgende Wert sein.

RP_FORCE

Wenden Sie alle Richtlinien erneut an, auch wenn keine Richtlinienänderung erkannt wurde.

Beachten Sie, dass clientseitige Erweiterungen, die zum Start- oder Anmeldezeitpunkt angewendet werden können (z. B. eine Anwendungsinstallationserweiterung), die Erweiterungen beim nächsten Start oder bei der nächsten Anmeldung erneut angewendet werden, auch wenn keine Richtlinienänderung erkannt wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn Sie den dwOptions-Parameter nicht angeben müssen, können Sie stattdessen die RefreshPolicy-Funktion aufrufen.

Standardmäßig wird die Richtlinie alle 90 Minuten erneut angewendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	userenv.h
Bibliothek	Userenv.lib
DLL	Userenv.dll