PSAM_PASSWORD_NOTIFICATION_ROUTINE funzione di callback (ntsecapi.h)

  • Articolo

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