ホーム › Security.Authentication.Identity › PLSA_REGISTER_NOTIFICATION

PLSA_REGISTER_NOTIFICATION

コールバック

シグネチャ

HANDLE PLSA_REGISTER_NOTIFICATION(
    LPTHREAD_START_ROUTINE StartFunction,
    void* Parameter,
    DWORD NotificationType,
    DWORD NotificationClass,
    DWORD NotificationFlags,
    DWORD IntervalMinutes,
    HANDLE WaitEvent
);

パラメーター

フィールド

型

説明

StartFunction

LPTHREAD_START_ROUTINE

通知を受け取るために呼び出される関数です。

Parameter

void*

StartFunction パラメーターで指定した関数に渡される引数です。

NotificationType

DWORD

通知の種類を指定します。有効な値は次の表のとおりです。

値	意味
NOTIFIER_TYPE_INTERVAL	一定間隔で通知します。間隔の長さは IntervalMinutes パラメーターで指定します。
NOTIFIER_TYPE_HANDLE_WAIT	WaitEvent パラメーターで指定したイベントハンドルがシグナル状態になったときに通知します。
NOTIFIER_TYPE_STATE_CHANGE	コンピューターのドメインまたはインストールの種類が変更されたときに通知します。
NOTIFIER_TYPE_NOTIFY_EVENT	セキュリティイベントが発生したときに通知します。対象とするイベントは NotificationClass パラメーターで指定します。
NOTIFIER_TYPE_IMMEDIATE	直ちに通知します。この値は NOTIFIER_FLAG_ONE_SHOT を指定したことを意味します。

NotificationClass

DWORD

通知を生成するイベントのクラスを指定します。NotificationType パラメーターに NOTIFIER_TYPE_NOTIFY_EVENT を設定する場合を除き、0 を指定します。

値	意味
NOTIFY_CLASS_PACKAGE_CHANGE	パッケージが読み込まれた、または新しいパッケージが優先パッケージとして選択されました。詳細については「解説」を参照してください。
NOTIFY_CLASS_ROLE_CHANGE	内部使用のために予約されています。
NOTIFY_CLASS_DOMAIN_CHANGE	内部使用のために予約されています。

NotificationFlags

DWORD

通知の動作を制御するフラグを指定します。

値	意味
NOTIFIER_FLAG_NEW_THREAD	新しいスレッドを使用して通知を待機します。
NOTIFIER_FLAG_ONE_SHOT	一度だけ通知します。
NOTIFIER_FLAG_SECONDS	IntervalMinutes パラメーターを秒単位として扱います。

IntervalMinutes

DWORD

通知と通知の間の待ち時間を指定します。

WaitEvent

HANDLE

省略可能です。イベントオブジェクトのハンドルです。このオブジェクトがシグナル状態になると通知が発生します。この値は NotificationType の値 NOTIFIER_TYPE_HANDLE_WAIT と組み合わせて使用します。

公式ドキュメント

セキュリティパッケージに通知を行うための仕組みを提供します。通知は、一定間隔ごと、イベントオブジェクトがシグナル状態になったとき、または特定のシステムイベントの発生時に行われます。

戻り値

関数が成功すると、戻り値は通知のハンドルです。

関数が失敗すると、戻り値は NULL です。

解説(Remarks)

NotificationClass パラメーターに NOTIFY_CLASS_PACKAGE_CHANGE 値を指定した場合、次の値が有効な変更を表します。

値	説明
SECPKG_PACKAGE_CHANGE_LOAD	パッケージが読み込まれました。
SECPKG_PACKAGE_CHANGE_UNLOAD	パッケージがアンロードされました。
SECPKG_PACKAGE_CHANGE_SELECT	新しいパッケージが優先されるセキュリティパッケージになりました。

RegisterNotification 関数へのポインターは、 LSA_SECPKG_FUNCTION_TABLE 構造体で利用できます。この構造体は SpInitialize 関数が受け取ります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)