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.

Syntax

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

Parameters

[in] InformationClass

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.

[in] NotificationEventHandle

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

Return value

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.

Requirements

See also

LsaUnregisterPolicyChangeNotification