RefreshPolicyEx-Funktion (userenv.h)
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 |