RegisterNotification function
Provides a mechanism whereby the security package is notified. Notification can occur at fixed intervals, when an event object is signaled, or during certain system events.
Syntax
HANDLE RegisterNotification( _In_ SEC_THREAD_START StartFunction, _In_ PVOID Parameter, _In_ ULONG NotificationType, _In_ ULONG NotificationClass, _In_ ULONG NotificationFlags, _In_ ULONG IntervalMinutes, _In_ HANDLE WaitEvent );
Parameters
- StartFunction [in]
-
The function that is called to accept notification.
- Parameter [in]
-
The argument of the function specified in the StartFunction parameter.
- NotificationType [in]
-
Specifies the type of notification. The following table lists the valid values.
- NotificationClass [in]
-
Specifies the class of events that generate notifications. Specify zero unless the NotificationType parameter is set to NOTIFIER_TYPE_NOTIFY_EVENT.
- NotificationFlags [in]
-
Specifies flags that control notification behavior.
Value Meaning - NOTIFIER_FLAG_NEW_THREAD
Wait for notification using a new thread.
- NOTIFIER_FLAG_ONE_SHOT
Notify only once.
- NOTIFIER_FLAG_SECONDS
The IntervalMinutes parameter specifies seconds.
- IntervalMinutes [in]
-
Specifies the time delay between notifications.
- WaitEvent [in]
-
Optional. Handle to an event object. When the object is signaled, the notification occurs. This value is used in conjunction with the NotificationType value NOTIFIER_TYPE_HANDLE_WAIT.
Return value
If the function succeeds, the return value is a handle to the notification.
If the function fails, the return value is NULL.
Remarks
If you specify the NOTIFY_CLASS_PACKAGE_CHANGE value for the NotificationClass parameter, the following values represent valid changes.
| Value | Description |
|---|---|
| SECPKG_PACKAGE_CHANGE_LOAD | A package was loaded. |
| SECPKG_PACKAGE_CHANGE_UNLOAD | A package was unloaded. |
| SECPKG_PACKAGE_CHANGE_SELECT | A new package became the preferred security package. |
A pointer to the RegisterNotification function is available in the LSA_SECPKG_FUNCTION_TABLE structure received by the SpInitialize function.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
See also