PSAM_PASSWORD_NOTIFICATION_ROUTINE Rückruffunktion (ntsecapi.h)

Artikel
08/25/2023

Die PasswordChangeNotify-Funktion wird von einer Kennwortfilter-DLL implementiert. Die DLL wird benachrichtigt, dass ein Kennwort geändert wurde.

Syntax

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

NTSTATUS PsamPasswordNotificationRoutine(
  [in] PUNICODE_STRING UserName,
  [in] ULONG RelativeId,
  [in] PUNICODE_STRING NewPassword
)
{...}

Parameter

[in] UserName

Der Kontoname des Benutzers, dessen Kennwort geändert wurde.

Wenn die Werte dieses Parameters und des NewPassword-ParametersNULL sind, sollte diese Funktion STATUS_SUCCESS zurückgeben.

[in] RelativeId

Der relative Bezeichner (RID) des in UserName angegebenen Benutzers.

[in] NewPassword

Ein neues Klartextkennwort für den in UserName angegebenen Benutzer. Wenn Sie das Kennwort verwendet haben, löschen Sie die Informationen, indem Sie die SecureZeroMemory-Funktion aufrufen. Weitere Informationen zum Schützen von Kennwörtern finden Sie unter Behandeln von Kennwörtern.

Wenn die Werte dieses Parameters und des UserName-ParametersNULL sind, sollte diese Funktion STATUS_SUCCESS zurückgeben.

Rückgabewert

Rückgabecode	Beschreibung
STATUS_SUCCESS	Gibt an, dass das Kennwort des Benutzers geändert wurde, oder dass die Werte der Parameter UserName und NewPasswordNULL sind.

Hinweise

Die PasswordChangeNotify-Funktion wird aufgerufen, nachdem die PasswordFilter-Funktion erfolgreich aufgerufen und das neue Kennwort gespeichert wurde.

Diese Funktion muss die __stdcall Aufrufkonvention verwenden und von der DLL exportiert werden.

Wenn die PasswordChangeNotify-Routine ausgeführt wird, wird die Verarbeitung blockiert, bis die Routine abgeschlossen ist. Verschieben Sie ggf. alle langwierigen Verarbeitungen in einen separaten Thread, bevor Sie von dieser Routine zurückkehren.

Diese Funktion wird nur für Kennwortfilter aufgerufen, die auf dem System installiert und registriert sind.

Jede Prozess-Ausnahme, die nicht innerhalb dieser Funktion behandelt wird, kann systemweit zu sicherheitsbezogenen Fehlern führen. Bei Bedarf sollte die strukturierte Ausnahmebehandlung verwendet werden.

Informationen über	Finden Sie unter
Programmierprobleme beim Implementieren einer Kennwortfilter-DLL	Überlegungen zur Kennwortfilterprogrammierung
So installieren und registrieren Sie Ihre eigene Kennwortfilter-DLL	Installieren und Registrieren einer Kennwortfilter-DLL
Die von Microsoft bereitgestellte Kennwortfilter-DLL	Sichere Kennworterzwingung und Passfilt.dll

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecapi.h

Weitere Informationen

InitializeChangeNotify

PasswordFilter

Freigeben über