RegisterGPNotification-Funktion (userenv.h)

  • Artikel

Mit der Funktion RegisterGPNotification kann eine Anwendung Benachrichtigungen empfangen, wenn eine Richtlinie geändert wird. Wenn eine Richtlinienänderung erfolgt, wird das angegebene Ereignisobjekt auf den signalierten Zustand festgelegt.

Syntax

USERENVAPI BOOL RegisterGPNotification(
  [in] HANDLE hEvent,
  [in] BOOL   bMachine
);

Parameter

[in] hEvent

Behandeln eines Ereignisobjekts. Verwenden Sie die CreateEvent-Funktion , um das Ereignisobjekt zu erstellen.

[in] bMachine

Gibt den Richtlinienänderungstyp an. Bei TRUE werden Computerrichtlinienänderungen gemeldet. Bei FALSE werden Benutzerrichtlinienänderungen gemeldet.

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

Rufen Sie die Funktion UnregisterGPNotification auf, um die Registrierung des Handle vom Empfangen von Richtlinienänderungsbenachrichtigungen aufzuheben. Rufen Sie die CloseHandle-Funktion auf, um das Handle zu schließen, wenn es nicht mehr benötigt wird.

Eine Anwendung kann auch Benachrichtigungen über Richtlinienänderungen empfangen, wenn eine WM_SETTINGCHANGE Nachricht gesendet wird. In diesem instance ist der wParam-Parameterwert 1, wenn die Computerrichtlinie angewendet wurde. Er ist null, wenn die Benutzerrichtlinie angewendet wurde. Der lParam-Parameter zeigt auf die Zeichenfolge "Policy".

Anforderungen

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

Weitere Informationen

Gruppenrichtlinie-Funktionen

Übersicht über Gruppenrichtlinien

Aufheben der Registrierung vonGPNotification