Fonction NPPasswordChangeNotify (npapi.h)

  • Article

Notes

Cette API a été dépréciée et sera supprimée dans une version ultérieure.

MPR appelle cette fonction pour notifier le gestionnaire d’informations d’identification d’un événement de modification de mot de passe. La fonction NPPasswordChangeNotify est implémentée par une DLL du gestionnaire d’informations d’identification.

Syntaxe

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

Paramètres

[in] lpAuthentInfoType

Pointeur vers une chaîne qui identifie le type de structure pointé vers lpAuthentInfo.

Lorsque Microsoft est l’authentificateur principal, la chaîne suivante est spécifiée pour les ouvertures de session interactives et de contrôleur de service.

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

Pointeur vers une structure qui contient les nouvelles informations d’identification.

Lorsque Microsoft est l’authentificateur principal (autrement dit, lorsque lpAuthentifoType est « MSV1_0 :Interactive » ou « Kerberos :Interactive »), la structure utilisée est MSV1_0_INTERACTIVE_LOGON ou KERB_INTERACTIVE_LOGON.

[in] lpPreviousAuthentInfoType

Pointeur vers une chaîne qui identifie le type de structure pointé vers lpPreviousAuthentInfo. Si le pointeur a la valeur NULL, il n’y avait aucune information précédente. Les valeurs attendues ici sont les mêmes que celles de lpAuthentInfoType.

Lorsque Microsoft est l’authentificateur principal, la chaîne suivante est spécifiée pour les ouvertures de session interactives et de contrôleur de service.

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

Pointeur vers une structure qui contient les informations d’identification utilisées avant que les informations d’authentification ne changent. Des informations préalables sont fournies si l’utilisateur a été forcé de modifier le mot de passe (ou d’autres informations d’authentification) avant de se connecter. Si l’utilisateur n’a pas été obligé de modifier les informations d’authentification, ce pointeur a la valeur NULL. Les valeurs attendues ici sont les mêmes que celles de lpAuthentInfo.

Lorsque Microsoft est l’authentificateur principal, la structure utilisée est MSV1_0_INTERACTIVE_LOGON ou KERB_INTERACTIVE_LOGON.

[in] lpStationName

Pointeur vers une chaîne qui spécifie le nom de la station à laquelle l’utilisateur s’est connecté. Le nom de la station peut être utilisé pour déterminer si des informations supplémentaires spécifiques au fournisseur peuvent être obtenues.

Lorsque Microsoft est l’authentificateur principal, l’une des chaînes suivantes est spécifiée.

Valeur Signification
WinSta_0
 Indique qu’il s’agit d’une ouverture de session interactive via la station de fenêtre. Dans ce cas, StationHandle est un HWND de la boîte de dialogue parente.
SvcCtl
 Indique qu’il s’agit d’une ouverture de session lancée par le contrôleur de service. StationHandle n’est pas utilisé dans ce cas.

[in] StationHandle

Valeur 32 bits dont la signification dépend du nom (et, par conséquent, du type) de la station spécifiée dans lpStationName.

Valeur Signification
WinSta_0
 Handle de la boîte de dialogue propriétaire (hwndOwner) actuellement affichée à l’écran.
SvcCtl
 Données aléatoires. Ne pas utiliser.

[in] dwChangeInfo

Si la valeur est définie, spécifie un indicateur qui fournit des informations sur les modifications. Ce paramètre peut être l’un des indicateurs.

Valeur Signification
WN_VALID_LOGON_ACCOUNT
 Cet indicateur indique que les informations d’authentification modifiées affecteront toutes les prochaines ouvertures de session. L’utilisateur appartient à un domaine approuvé.
WN_NT_PASSWORD_CHANGED
 Cet indicateur indique que le mot de passe a été modifié.

Certaines modifications d’informations d’authentification affectent uniquement les connexions effectuées dans des domaines non approuvés. Il s’agit des comptes que l’utilisateur ne peut pas utiliser pour se connecter à cet ordinateur. Dans ce cas, dwChangeInfo n’est pas défini.

Valeur retournée

Si la fonction réussit, la fonction retourne WN_SUCCESS.

Si la fonction échoue, elle retourne un code d’erreur, qui peut être l’une des valeurs suivantes.

Code de retour Description
WN_NOT_SUPPORTED

NPPasswordChangeNotify n’est pas pris en charge.
WN_NO_NETWORK
 Le réseau n’est pas présent.
WN_FUNCTION_BUSY
 Le gestionnaire d’informations d’identification est toujours en cours d’initialisation et n’est pas prêt à être appelé.

Remarques

La fonction NPPasswordChangeNotify est implémentée par les gestionnaires d’informations d’identification pour recevoir des notifications lorsque les informations d’authentification changent.

Windows Server 2003 et Windows XP : NPPasswordChangeNotify est appelé sur un ordinateur auquel un utilisateur se connecte si le mot de passe a été modifié ailleurs. Notez que ce comportement n’est pas pris en charge à partir de Windows Vista et Windows Server 2008.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête npapi.h

Voir aussi

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify