PSAM_PASSWORD_NOTIFICATION_ROUTINE fonction de rappel (ntsecapi.h)

Article
03/04/2024

La fonction PasswordChangeNotify est implémentée par une DLL de filtre de mot de passe . Il avertit la DLL qu’un mot de passe a été modifié.

Syntaxe

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

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

Paramètres

[in] UserName

Nom du compte de l’utilisateur dont le mot de passe a été modifié.

Si les valeurs de ce paramètre et du paramètre NewPassword sont NULL, cette fonction doit retourner STATUS_SUCCESS.

[in] RelativeId

Identificateur relatif (RID) de l’utilisateur spécifié dans UserName.

[in] NewPassword

Nouveau mot de passe en texte clair pour l’utilisateur spécifié dans UserName. Lorsque vous avez terminé d’utiliser le mot de passe, effacez les informations en appelant la fonction SecureZeroMemory . Pour plus d’informations sur la protection des mots de passe, consultez Gestion des mots de passe.

Si les valeurs de ce paramètre et du paramètre UserName sont NULL, cette fonction doit retourner STATUS_SUCCESS.

Valeur retournée

Code de retour	Description
STATUS_SUCCESS	Indique que le mot de passe de l’utilisateur a été modifié ou que les valeurs des paramètres UserName et NewPassword sont NULL.

Remarques

La fonction PasswordChangeNotify est appelée une fois que la fonction PasswordFilter a été appelée correctement et que le nouveau mot de passe a été stocké.

Cette fonction doit utiliser la convention d’appel __stdcall et doit être exportée par la DLL.

Lorsque la routine PasswordChangeNotify est en cours d’exécution, le traitement est bloqué jusqu’à ce que la routine soit terminée. Le cas échéant, déplacez tout traitement long vers un thread distinct avant de revenir de cette routine.

Cette fonction est appelée uniquement pour les filtres de mot de passe installés et inscrits sur le système.

Toute exception de processus qui n’est pas gérée dans cette fonction peut entraîner des défaillances liées à la sécurité à l’échelle du système. La gestion structurée des exceptions doit être utilisée le cas échéant.

Pour obtenir des informations sur	Consultez
Problèmes de programmation lors de l’implémentation d’une DLL de filtre de mot de passe	Considérations relatives à la programmation du filtre de mot de passe
Comment installer et inscrire votre propre DLL de filtre de mot de passe	Installation et inscription d’une DLL de filtre de mot de passe
DLL de filtre de mot de passe fournie par Microsoft	Application et Passfilt.dllde mot de passe forts

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ntsecapi.h

Voir aussi

InitializeChangeNotify

PasswordFilter

Partager via