nf-ntsecapi-lsaregisterpolicychangenotification.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:ntsecapi.LsaRegisterPolicyChangeNotification	LsaRegisterPolicyChangeNotification function (ntsecapi.h)	The LsaRegisterPolicyChangeNotification function registers an event handle with the local security authority (LSA). This event handle is signaled whenever the indicated LSA policy is modified.	LsaRegisterPolicyChangeNotification LsaRegisterPolicyChangeNotification function [Security] PolicyNotifyAccountDomainInformation PolicyNotifyAuditEventsInformation PolicyNotifyDnsDomainInformation PolicyNotifyDomainEfsInformation PolicyNotifyDomainKerberosTicketInformation PolicyNotifyServerRoleInformation _lsa_lsaregisterpolicychangenotification ntsecapi/LsaRegisterPolicyChangeNotification security.lsaregisterpolicychangenotification	security\lsaregisterpolicychangenotification.htm	security	0c713d2b-e13a-44e0-8b48-68b233d1c562	12/05/2018	LsaRegisterPolicyChangeNotification, LsaRegisterPolicyChangeNotification function [Security], PolicyNotifyAccountDomainInformation, PolicyNotifyAuditEventsInformation, PolicyNotifyDnsDomainInformation, PolicyNotifyDomainEfsInformation, PolicyNotifyDomainKerberosTicketInformation, PolicyNotifyServerRoleInformation, _lsa_lsaregisterpolicychangenotification, ntsecapi/LsaRegisterPolicyChangeNotification, security.lsaregisterpolicychangenotification	ntsecapi.h		Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]										Secur32.lib	Secur32.dll		Windows			19H1	LsaRegisterPolicyChangeNotification ntsecapi/LsaRegisterPolicyChangeNotification	c++	APIRef kbSyntax	DllExport	Secur32.dll	LsaRegisterPolicyChangeNotification

LsaRegisterPolicyChangeNotification function

-description

The LsaRegisterPolicyChangeNotification function registers an event handle with the local security authority (LSA). This event handle is signaled whenever the indicated LSA policy is modified.

-parameters

-param InformationClass [in]

A POLICY_NOTIFICATION_INFORMATION_CLASS value that specifies the type of policy changes about which your application will be notified. Specify one of the following values.

Value	Meaning
PolicyNotifyAuditEventsInformation	Auditing policy changes.
PolicyNotifyAccountDomainInformation	Account domain information changes.
PolicyNotifyServerRoleInformation	Server role changes.
PolicyNotifyDomainEfsInformation	EFS policy information changes.
PolicyNotifyDomainKerberosTicketInformation	Kerberos ticket policy information changes.
PolicyNotifyDnsDomainInformation	Domain Name System (DNS) information, name, or SID of the system's primary domain changes.

-param NotificationEventHandle [in]

A handle to an event obtained by calling the CreateEvent function. The event can be either named or unnamed.

-returns

If the function succeeds, the return value is STATUS_SUCCESS.

If the function fails, the return value is an NTSTATUS code. For more information, see LSA Policy Function Return Values.

You can use the LsaNtStatusToWinError function to convert the NTSTATUS code to a Windows error code.

-remarks

When you have finished using a notification event that has been registered by the LsaRegisterPolicyChangeNotification function, unregister it by calling the LsaUnregisterPolicyChangeNotification function.

For an example that demonstrates calling this function, see Receiving Policy Change Events.

-see-also

LsaUnregisterPolicyChangeNotification