PSAM_PASSWORD_NOTIFICATION_ROUTINE funzione di callback (ntsecapi.h)

Articolo
03/05/2024

La funzione PasswordChangeNotify viene implementata da una DLL di filtro password . Notifica alla DLL che una password è stata modificata.

Sintassi

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

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

Parametri

[in] UserName

Nome dell'account dell'utente la cui password è stata modificata.

Se i valori di questo parametro e il parametro NewPassword sono NULL, questa funzione deve restituire STATUS_SUCCESS.

[in] RelativeId

Identificatore relativo (RID) dell'utente specificato in UserName.

[in] NewPassword

Nuova password di testo non crittografato per l'utente specificato in UserName. Al termine dell'uso della password, cancellare le informazioni chiamando la funzione SecureZeroMemory . Per altre informazioni sulla protezione delle password, vedere Gestione delle password.

Se i valori di questo parametro e del parametro UserName sono NULL, questa funzione deve restituire STATUS_SUCCESS.

Valore restituito

Codice restituito	Descrizione
STATUS_SUCCESS	Indica che la password dell'utente è stata modificata o che i valori dei parametri UserName e NewPassword sono NULL.

Commenti

La funzione PasswordChangeNotify viene chiamata dopo che la funzione PasswordFilter è stata chiamata correttamente e la nuova password è stata archiviata.

Questa funzione deve usare la convenzione di chiamata __stdcall e deve essere esportata dalla DLL.

Quando la routine PasswordChangeNotify è in esecuzione, l'elaborazione viene bloccata fino al termine della routine. Se appropriato, spostare qualsiasi elaborazione lunga in un thread separato prima di tornare da questa routine.

Questa funzione viene chiamata solo per i filtri password installati e registrati nel sistema.

Qualsiasi eccezione di processo non gestita all'interno di questa funzione può causare errori correlati alla sicurezza a livello di sistema. La gestione delle eccezioni strutturata deve essere usata quando appropriato.

Per informazioni su	Vedere
Problemi di programmazione durante l'implementazione di una DLL di filtro delle password	Considerazioni sulla programmazione del filtro password
Come installare e registrare la DLL del filtro password	Installazione e registrazione di una DLL di filtro password
DLL di filtro password fornita da Microsoft	Applicazione e Passfilt.dllpassword complesse

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntsecapi.h

Vedi anche

InitializeChangeNotify

PasswordFilter

Condividi tramite