PSAM_INIT_NOTIFICATION_ROUTINE callback function (ntsecapi.h)

Article
10/05/2021

The InitializeChangeNotify function is implemented by a password filter DLL. This function initializes the DLL.

Syntax

PSAM_INIT_NOTIFICATION_ROUTINE PsamInitNotificationRoutine;

BOOLEAN PsamInitNotificationRoutine()
{...}

Parameters

This callback function has no parameters.

Return value

Return code	Description
TRUE	The password filter DLL is initialized.
FALSE	The password filter DLL is not initialized.

Remarks

InitializeChangeNotify is called by the Local Security Authority (LSA) to verify that the password notification DLL is loaded and initialized.

This function must use the __stdcall calling convention, and must be exported by the DLL.

This function is called only for password filters that are installed and registered on a system.

Any process exception that is not handled within this function may cause security-related failures system-wide. Structured exception handling should be used when appropriate.

For information about	See
Programming issues when implementing a password filter DLL	Password Filter Programming Considerations
How to install and register your own password filter DLL	Installing and Registering a Password Filter DLL
The password filter DLL provided by Microsoft	Strong Password Enforcement and Passfilt.dll

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	ntsecapi.h