Share via

RegisterGPNotification 関数 (userenv.h)

  • [アーティクル]

RegisterGPNotification 関数を使用すると、ポリシーに変更があった場合にアプリケーションが通知を受け取ります。 ポリシーの変更が発生すると、指定したイベント オブジェクトがシグナル状態に設定されます。

構文

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

パラメーター

[in] hEvent

イベント オブジェクトを処理します。 CreateEvent 関数を使用して、イベント オブジェクトを作成します。

[in] bMachine

ポリシー変更の種類を指定します。 TRUE の場合、コンピューター ポリシーの変更が報告されます。 FALSE の場合、ユーザー ポリシーの変更が報告されます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

UnregisterGPNotification 関数を呼び出して、ポリシー変更通知の受信からハンドルの登録を解除します。 CloseHandle 関数を呼び出して、不要になったハンドルを閉じます。

アプリケーションは、 WM_SETTINGCHANGE メッセージがブロードキャストされるときにポリシーの変更に関する通知を受け取ることもできます。 このインスタンスでは、コンピューター ポリシーが適用された場合、 wParam パラメーターの値は 1 です。ユーザー ポリシーが適用された場合は 0 です。 lParam パラメーターは、文字列 "Policy" を指します。

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー userenv.h
Library Userenv.lib
[DLL] Userenv.dll

関連項目

グループ ポリシー関数

グループ ポリシーの概要

UnregisterGPNotification