PSAM_PASSWORD_NOTIFICATION_ROUTINE Rückruffunktion (ntsecapi.h)
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 |
|---|---|
|
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 |