registerGPNotification 函式 (userenv.h)

RegisterGPNotification函式可讓應用程式在原則中有變更時接收通知。發生原則變更時，指定的事件物件會設定為已發出訊號的狀態。

語法

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

[in] hEvent

事件物件的控制碼。使用 CreateEvent 函式來建立事件物件。

[in] bMachine

指定原則變更類型。如果 為 TRUE，則會報告電腦原則變更。如果 為 FALSE，則會報告使用者原則變更。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

呼叫 UnregisterGPNotification 函式，以從接收原則變更通知取消註冊控制碼。呼叫 CloseHandle 函式，以在不再需要控制碼時關閉控制碼。

當廣播WM_SETTINGCHANGE 訊息時，應用程式也可以接收原則變更的相關通知。在此實例中，如果套用電腦原則， wParam 參數值為 1;如果套用使用者原則，則為零。 lParam參數指向字串「Policy」。