Compartir a través de

Función NPPasswordChangeNotify (npapi.h)

  • Artículo

Nota

Esta API está en desuso y se quitará en una versión futura.

MPR llama a esta función para notificar al administrador de credenciales un evento de cambio de contraseña. La función NPPasswordChangeNotify se implementa mediante un archivo DLL del administrador de credenciales.

Sintaxis

DWORD NPPasswordChangeNotify(
  [in] LPCWSTR lpAuthentInfoType,
  [in] LPVOID  lpAuthentInfo,
  [in] LPCWSTR lpPreviousAuthentInfoType,
  [in] LPVOID  lpPreviousAuthentInfo,
  [in] LPWSTR  lpStationName,
  [in] LPVOID  StationHandle,
  [in] DWORD   dwChangeInfo
);

Parámetros

[in] lpAuthentInfoType

Puntero a una cadena que identifica el tipo de estructura a la que apunta lpAuthentInfo.

Cuando Microsoft es el autenticador principal, se especifica la siguiente cadena para los inicios de sesión interactivos y del controlador de servicio.

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

Puntero a una estructura que contiene las nuevas credenciales.

Cuando Microsoft es el autenticador principal (es decir, cuando lpAuthentifoType es "MSV1_0:Interactive" o "Kerberos:Interactive"), la estructura usada se MSV1_0_INTERACTIVE_LOGON o KERB_INTERACTIVE_LOGON.

[in] lpPreviousAuthentInfoType

Puntero a una cadena que identifica el tipo de estructura a la que apunta lpPreviousAuthentInfo. Si el puntero es NULL, no hubo información anterior. Los valores que se esperan aquí son los mismos que los de lpAuthentInfoType.

Cuando Microsoft es el autenticador principal, se especifica la siguiente cadena para los inicios de sesión interactivos y del controlador de servicio.

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

Puntero a una estructura que contiene las credenciales usadas antes del cambio de información de autenticación. Se proporciona información anterior si el usuario se vio obligado a cambiar la contraseña (u otra información de autenticación) antes de iniciar sesión. Si el usuario no se vio obligado a cambiar la información de autenticación, este puntero es NULL. Los valores esperados aquí son los mismos que los de lpAuthentInfo.

Cuando Microsoft es el autenticador principal, la estructura usada se MSV1_0_INTERACTIVE_LOGON o KERB_INTERACTIVE_LOGON.

[in] lpStationName

Puntero a una cadena que especifica el nombre de la estación en la que el usuario ha iniciado sesión. El nombre de la estación se puede usar para determinar si se puede obtener información adicional específica del proveedor.

Cuando Microsoft es el autenticador principal, se especificará una de las siguientes cadenas.

Valor Significado
WinSta_0
 Indica que se trata de un inicio de sesión interactivo a través de la estación de ventanas. En este caso, StationHandle es un HWND en el cuadro de diálogo primario.
SvcCtl
 Indica que se trata de un inicio de sesión iniciado por el controlador de servicio. StationHandle no se usa en este caso.

[in] StationHandle

Valor de 32 bits cuyo significado depende del nombre (y, por consiguiente, del tipo) de la estación especificada en lpStationName.

Valor Significado
WinSta_0
 Identificador del cuadro de diálogo propietario (hwndOwner) que se muestra actualmente en la pantalla.
SvcCtl
 Datos aleatorios. No debe usarse.

[in] dwChangeInfo

Si se establece, especifica una marca que proporciona información de cambio. Este parámetro puede ser una de las marcas.

Valor Significado
WN_VALID_LOGON_ACCOUNT
 Esta marca indica que la información de autenticación modificada afectará a todos los inicios de sesión futuros. El usuario pertenece a un dominio de confianza.
WN_NT_PASSWORD_CHANGED
 Esta marca indica que se cambió la contraseña.

Algunos cambios de información de autenticación solo afectarán a las conexiones realizadas en dominios que no son de confianza. Estas son las cuentas que el usuario no puede usar para iniciar sesión en este equipo de todos modos. En estos casos, dwChangeInfo no se establece.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve WN_SUCCESS.

Si se produce un error en la función, devuelve un código de error, que puede ser uno de los siguientes valores.

Código devuelto Descripción
WN_NOT_SUPPORTED

NO se admite NPPasswordChangeNotify.
WN_NO_NETWORK
 La red no está presente.
WN_FUNCTION_BUSY
 El administrador de credenciales sigue inicializando y no está listo para llamarse.

Comentarios

Los administradores de credenciales implementan la función NPPasswordChangeNotify para recibir notificaciones cuando cambia la información de autenticación.

Windows Server 2003 y Windows XP: se llama a NPPasswordChangeNotify en un equipo en el que un usuario inicia sesión si la contraseña se ha cambiado en otro lugar. Tenga en cuenta que este comportamiento no se admite a partir de Windows Vista y Windows Server 2008.

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 npapi.h

Consulte también

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify