Funzione NPPasswordChangeNotify (npapi.h)

  • Articolo

Nota

Questa API è stata deprecata e verrà rimossa in una versione futura.

MPR chiama questa funzione per notificare al gestore credenziali un evento di modifica della password. La funzione NPPasswordChangeNotify viene implementata da una DLL di gestione credenziali.

Sintassi

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

Parametri

[in] lpAuthentInfoType

Puntatore a una stringa che identifica il tipo di struttura a cui punta lpAuthentInfo.

Quando Microsoft è l'autenticatore primario, viene specificata la stringa seguente per gli accessi interattivi e del controller di servizio.

MSV1_0:Interactive 
Kerberos:Interactive

[in] lpAuthentInfo

Puntatore a una struttura che contiene le nuove credenziali.

Quando Microsoft è l'autenticatore primario , ovvero quando lpAuthentifoType è "MSV1_0:Interactive" o "Kerberos:Interactive"), la struttura usata viene MSV1_0_INTERACTIVE_LOGON o KERB_INTERACTIVE_LOGON.

[in] lpPreviousAuthentInfoType

Puntatore a una stringa che identifica il tipo di struttura a cui punta lpPreviousAuthentInfo. Se il puntatore è NULL, non sono presenti informazioni precedenti. I valori previsti sono gli stessi di quelli in lpAuthentInfoType.

Quando Microsoft è l'autenticatore primario, viene specificata la stringa seguente per gli accessi interattivi e del controller di servizio.

MSV1_0:Interactive

[in] lpPreviousAuthentInfo

Puntatore a una struttura che contiene le credenziali usate prima della modifica delle informazioni di autenticazione. Le informazioni precedenti vengono fornite se l'utente è stato costretto a modificare la password (o altre informazioni di autenticazione) prima dell'accesso. Se l'utente non è stato costretto a modificare le informazioni di autenticazione, questo puntatore è NULL. I valori previsti sono uguali a quelli in lpAuthentInfo.

Quando Microsoft è l'autenticatore primario, la struttura utilizzata viene MSV1_0_INTERACTIVE_LOGON o KERB_INTERACTIVE_LOGON.

[in] lpStationName

Puntatore a una stringa che specifica il nome della stazione a cui l'utente ha effettuato l'accesso. Il nome della stazione può essere utilizzato per determinare se è possibile ottenere informazioni aggiuntive specifiche del provider.

Quando Microsoft è l'autenticatore primario, verrà specificata una delle stringhe seguenti.

Valore Significato
WinSta_0
 Indica che si tratta di un accesso interattivo attraverso la stazione finestra. In questo caso , StationHandle è un HWND nella finestra di dialogo padre.
SvcCtl
 Indica che si tratta di un accesso avviato dal controller del servizio. StationHandle non viene usato in questo caso.

[in] StationHandle

Valore a 32 bit il cui significato dipende dal nome (e di conseguenza dal tipo) della stazione specificata in lpStationName.

Valore Significato
WinSta_0
 Handle per la finestra di dialogo proprietario (hwndOwner) attualmente visualizzata sullo schermo.
SvcCtl
 Dati casuali. Non usare.

[in] dwChangeInfo

Se impostato, specifica un flag che fornisce informazioni sulle modifiche. Questo parametro può essere uno dei flag.

Valore Significato
WN_VALID_LOGON_ACCOUNT
 Questo flag indica che le informazioni di autenticazione modificate avranno effetto su tutti gli accessi futuri. L'utente appartiene a un dominio attendibile.
WN_NT_PASSWORD_CHANGED
 Questo flag indica che la password è stata modificata.

Alcune modifiche alle informazioni di autenticazione influiranno solo sulle connessioni effettuate in domini non attendibili. Si tratta degli account che l'utente non può usare per accedere comunque a questo computer. In questi casi , dwChangeInfo non è impostato.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce WN_SUCCESS.

Se la funzione ha esito negativo, restituisce un codice di errore, che può essere uno dei valori seguenti.

Codice restituito Descrizione
WN_NOT_SUPPORTED

NPPasswordChangeNotify non è supportato.
WN_NO_NETWORK
 La rete non è presente.
WN_FUNCTION_BUSY
 Gestione credenziali sta ancora inizializzando e non è pronto per essere chiamato.

Commenti

La funzione NPPasswordChangeNotify viene implementata dai gestori delle credenziali per ricevere notifiche quando vengono modificate le informazioni di autenticazione.

Windows Server 2003 e Windows XP: NPPasswordChangeNotify viene chiamato in un computer in cui un utente accede se la password è stata modificata altrove. Si noti che questo comportamento non è supportato a partire da Windows Vista e Windows Server 2008.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione npapi.h

Vedi anche

MSV1_0_INTERACTIVE_LOGON

NPGetCaps

NPLogonNotify