PSAM_PASSWORD_NOTIFICATION_ROUTINE función de devolución de llamada (ntsecapi.h)

Una DLL de filtro de contraseña implementa la función PasswordChangeNotify. Notifica al archivo DLL que se cambió una contraseña.

Sintaxis

PSAM_PASSWORD_NOTIFICATION_ROUTINE PsamPasswordNotificationRoutine;

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

Parámetros

[in] UserName

Nombre de cuenta del usuario cuya contraseña cambió.

Si los valores de este parámetro y el parámetro NewPassword son NULL, esta función debe devolver STATUS_SUCCESS.

[in] RelativeId

Identificador relativo (RID) del usuario especificado en UserName.

[in] NewPassword

Nueva contraseña de texto no cifrado para el usuario especificado en UserName. Cuando haya terminado de usar la contraseña, borre la información llamando a la función SecureZeroMemory . Para obtener más información sobre la protección de contraseñas, consulte Control de contraseñas.

Si los valores de este parámetro y el parámetro UserName son NULL, esta función debe devolver STATUS_SUCCESS.

Valor devuelto

Código devuelto	Descripción
STATUS_SUCCESS	Indica que se cambió la contraseña del usuario o que los valores de los parámetros UserName y NewPassword son NULL.

Comentarios

Se llama a la función PasswordChangeNotify después de que se haya llamado correctamente a la función PasswordFilter y se haya almacenado la nueva contraseña.

Esta función debe usar la convención de llamada __stdcall y debe exportarse por el archivo DLL.

Cuando se ejecuta la rutina PasswordChangeNotify , el procesamiento se bloquea hasta que finaliza la rutina. Cuando corresponda, mueva cualquier procesamiento largo a un subproceso independiente antes de volver de esta rutina.

Esta función se llama solo para los filtros de contraseña instalados y registrados en el sistema.

Cualquier excepción de proceso que no se controle dentro de esta función puede provocar errores relacionados con la seguridad en todo el sistema. El control estructurado de excepciones debe usarse cuando sea adecuado.

Para información acerca de	Vea
Problemas de programación al implementar un archivo DLL de filtro de contraseña	Consideraciones de programación del filtro de contraseñas
Cómo instalar y registrar su propia DLL de filtro de contraseña	Instalación y registro de un archivo DLL de filtro de contraseña
El archivo DLL de filtro de contraseña proporcionado por Microsoft	Aplicación segura de contraseñas y Passfilt.dll

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntsecapi.h

Consulte también

InitializeChangeNotify

PasswordFilter