PSAM_PASSWORD_NOTIFICATION_ROUTINE função de retorno de chamada (ntsecapi.h)

A função PasswordChangeNotify é implementada por uma DLL de filtro de senha . Ele notifica a DLL de que uma senha foi alterada.

Sintaxe

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

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

Parâmetros

[in] UserName

O nome da conta do usuário cuja senha foi alterada.

Se os valores desse parâmetro e o parâmetro NewPassword forem NULL, essa função deverá retornar STATUS_SUCCESS.

[in] RelativeId

O RID (identificador relativo ) do usuário especificado em UserName.

[in] NewPassword

Uma nova senha de texto não criptografado para o usuário especificado em UserName. Quando terminar de usar a senha, desmarque as informações chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger senhas, consulte Manipulando senhas.

Se os valores desse parâmetro e o parâmetro UserName forem NULL, essa função deverá retornar STATUS_SUCCESS.

Retornar valor

Comentários

A função PasswordChangeNotify é chamada depois que a função PasswordFilter foi chamada com êxito e a nova senha foi armazenada.

Essa função deve usar a convenção de chamada __stdcall e deve ser exportada pela DLL.

Quando a rotina PasswordChangeNotify está em execução, o processamento é bloqueado até que a rotina seja concluída. Quando apropriado, mova qualquer processamento longo para um thread separado antes de retornar dessa rotina.

Essa função é chamada apenas para filtros de senha instalados e registrados no sistema.

Qualquer exceção de processo que não seja tratada nessa função pode causar falhas relacionadas à segurança em todo o sistema. A manipulação de exceção estruturada deve ser usada quando apropriado.

Requisitos

Confira também

InitializeChangeNotify

PasswordFilter