LsaRegisterPolicyChangeNotification 関数 (ntsecapi.h)

  • [アーティクル]

LsaRegisterPolicyChangeNotification 関数は、イベント ハンドルをローカル セキュリティ機関 (LSA) に登録します。 このイベント ハンドルは、指定された LSA ポリシーが変更されるたびに通知されます。

構文

NTSTATUS LsaRegisterPolicyChangeNotification(
  [in] POLICY_NOTIFICATION_INFORMATION_CLASS InformationClass,
  [in] HANDLE                                NotificationEventHandle
);

パラメーター

[in] InformationClass

アプリケーション に 通知するポリシー変更の種類を指定するPOLICY_NOTIFICATION_INFORMATION_CLASS値。 次のいずれかの値を指定します。

値 意味
PolicyNotifyAuditEventsInformation
 ポリシーの変更の監査。
PolicyNotifyAccountDomainInformation
 アカウント ドメイン情報の変更。
PolicyNotifyServerRoleInformation
 サーバー ロールの変更。
PolicyNotifyDomainEfsInformation
 EFS ポリシー情報の変更。
PolicyNotifyDomainKerberosTicketInformation
 Kerberos チケット ポリシー情報の変更。
PolicyNotifyDnsDomainInformation
 システムのプライマリ ドメイン変更のドメイン ネーム システム (DNS) 情報、名前、または SID。

[in] NotificationEventHandle

CreateEvent 関数を呼び出して取得したイベントへのハンドル。 イベントには名前を付けるか、名前を付けずにすることができます。

戻り値

関数が成功した場合、戻り値はSTATUS_SUCCESS。

関数が失敗した場合、戻り値は NTSTATUS コードです。 詳細については、「 LSA ポリシー関数の戻り値」を参照してください。

LsaNtStatusToWinError 関数を使用して、NTSTATUS コードを Windows エラー コードに変換できます。

注釈

LsaRegisterPolicyChangeNotification 関数によって登録された通知イベントの使用が完了したら、LsaUnregisterPolicyChangeNotification 関数を呼び出して登録を解除します。

この関数の呼び出しを示す例については、「 ポリシー変更イベントの受信」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntsecapi.h
Library Secur32.lib
[DLL] Secur32.dll

こちらもご覧ください

LsaUnregisterPolicyChangeNotification