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

Código de retorno	Descrição
STATUS_SUCCESS	Indica que a senha do usuário foi alterada ou que os valores dos parâmetros UserName e NewPassword são NULL.

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.

Para obter informações sobre	Consulte
Problemas de programação ao implementar uma DLL de filtro de senha	Considerações sobre programação de filtro de senha
Como instalar e registrar sua própria DLL de filtro de senha	Instalando e registrando uma DLL de filtro de senha
A DLL do filtro de senha fornecida pela Microsoft	Imposição forte de senha e Passfilt.dll

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntsecapi.h

Confira também

InitializeChangeNotify

PasswordFilter